
Security News
Django Joins curl in Pushing Back on AI Slop Security Reports
Django has updated its security policies to reject AI-generated vulnerability reports that include fabricated or unverifiable content.
Python wrapper around the command line interface for The Private Internet Access Desktop Client. Intended to facilitate the operation of the PIA client from within Python.
Python 3.7, no additional dependencies.
Use the package manager pip to install piapy.
pip install piapy
PIA Desktop client must be installed.
Command piactl
must be available from your terminal. Try running piactl --version
. Iif you get something like 2.0.1+04518
you are good to go.
If it does not run, please check PIA Desktop: Command Line Interface documentation.
PIA client must be running to use the connect method.
regions()
Returns list of strings with available servers.
i.e.: ['us-florida', 'us-atlanta', 'us-houston', 'us-washington-dc', 'us-east', 'us-chicago', 'us-new-york-city', 'us-texas', 'us-west', ...]
region()
Returns string of current selected server name.
i.e. 'us-houston'
set_region(server='auto')
Cause the client to connect to selected server next time it connects. If client is already connected will disconnect and connect to new selected server.
connect(verbose=False, timeout=20)
Cause the client to connect
disconnect()
Cause client to disconnect
ip()
Returns the current VPN IP address, if connected and the address is known
status()
Returns client conection status.
Disconnected, Connecting, StillConnecting, Connected, Interrupted, Reconnecting, StillReconnecting, DisconnectingToReconnect, Disconnecting
reset_settings()
Resets settings to the defaults. As per the documentation this only resets daemon settings, no GUI settings.
set_debug_logging(value=False)
Enable client debug logging.
from piapy import PiaVpn
# Instantiate
vpn = PiaVpn()
# Get connection status
vpn.status() # equivalent to `piactl get connectionstate`
# Will connect to server, displaying status in stdout
vpn.connect(verbose=True, timeout=20)
# Disconnect
vpn.disconnect()
Pull requests are welcome. Please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
The piapy software is a personal project. I have no prior or existing relationship with Private Internet Access
If you have any information regarding its software, you can visit them:
with MIT open source license.
FAQs
Python wrapper for PIA VPN desktop client command line interface
We found that piapy demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Django has updated its security policies to reject AI-generated vulnerability reports that include fabricated or unverifiable content.
Security News
ECMAScript 2025 introduces Iterator Helpers, Set methods, JSON modules, and more in its latest spec update approved by Ecma in June 2025.
Security News
A new Node.js homepage button linking to paid support for EOL versions has sparked a heated discussion among contributors and the wider community.