Installation
PyPI Install (Recommended)
projectaria_login is published to PyPI as projectaria-login. Install it in a virtual environment:
- Linux & macOS
- Windows
python3 -m venv ~/projectaria_gen2_python_env
source ~/projectaria_gen2_python_env/bin/activate
python3 -m pip install --upgrade pip
python3 -m pip install projectaria-login
python -m venv $env:USERPROFILE\projectaria_gen2_python_env
& $env:USERPROFILE\projectaria_gen2_python_env\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install projectaria-login
Verify installation:
projectaria_login --help
Expected output shows login, verify, and logout subcommands.
Keyring Prerequisites
projectaria_login stores tokens securely in your operating system's credential manager. No additional system packages are required on macOS or Windows.
Prerequisite for keyring token storage on Linux
On Linux, secure token storage needs a Secret Service provider:
| Distro | Package to install |
|---|---|
| Ubuntu / Debian | sudo apt install gnome-keyring (or, for KWallet users, sudo apt install kwalletmanager) |
| Fedora | sudo dnf install gnome-keyring |
Start the keyring daemon once per session if running headless:
eval $(gnome-keyring-daemon --start)
Supported Platforms
| OS | Keyring Backend | Python |
|---|---|---|
| macOS 14+ Apple Silicon | macOS Keychain | 3.9 – 3.12 |
| Linux x64 Ubuntu 22.04/24.04, Fedora 40/41 | Secret Service / GNOME Keyring / KWallet | 3.9 – 3.12 |
| Windows x64 | Windows Credential Manager | 3.9 – 3.12 |
Next Steps
- CLI Usage — log in and out from terminal