PX Secrets
github.com
- Free plan
- Windows
- macOS
- Linux
- Web
- API
- Self-hosted
What PX Secrets is
PX Secrets is a free, open-source secrets manager that stores an encrypted vault on your machine. It uses SOPS and AGE for on-disk encryption, while the project says the private AGE key is read directly by SOPS rather than handled by PX Secrets. A dark web interface provides search and service grouping, with an optional native desktop window through pywebview. The command-line tool lists services and retrieves named secrets for scripts. A local API supports runtime retrieval by scripts and AI agents, and the application can run headlessly as a background service. Documentation covers Docker deployment, CI/CD pipelines, and use by automation. The project states that it makes no network calls and collects no telemetry, analytics, usage tracking, or crash reports. Clipboard copies clear after 30 seconds, and temporary plaintext files are deleted after encryption. PX Secrets is self-hosted, licensed under AGPL-3.0, and supports macOS and Linux; Windows is untested.
Who it suits
It suits developers, AI builders, homelabbers, and sysadmins who want a local, self-hosted vault. Users must be prepared to protect the AGE private key and secure the local API.
Good to know, and what to watch
- Free and open source under AGPL-3.0
- Stores an encrypted local vault
- Provides web, desktop, CLI, and API access
- Makes no network calls or telemetry
- Supports headless and CI/CD use
- Local API is unauthenticated by default
- Losing the AGE key prevents vault recovery
- Windows support is untested
- Requires Python 3.9+, SOPS, and AGE
Plans
Every plan and pricePX Secrets
Free plan
The verdict
PX Secrets focuses on local control, encrypted storage, and scriptable access without network telemetry. Its unauthenticated default API and irreversible key loss make deployment and key handling important responsibilities.
What the maker publishes
- API security limit
- The local API is unauthenticated by default; the README warns against exposing port 9999 outside the local host or a trusted private network without authentication. source
- CLI
- The CLI can list services and retrieve secrets by name for scripts. source
- Clipboard
- Copied secrets are automatically cleared from the clipboard after 30 seconds. source
- Encryption
- It encrypts the vault on disk with SOPS and AGE, and the repository says the private AGE key is read directly by SOPS and never touched by PX Secrets. source
- Integrations
- The README documents SOPS and AGE dependencies, Docker deployment, and runtime use by scripts, AI agents, and CI/CD pipelines. source
- Intended users
- The README describes it as suited to developers, AI builders, homelabbers, and sysadmins. source
- Interface
- It provides a dark web UI with search and service grouping, plus an optional native desktop window using pywebview. source
- Key recovery limit
- The README states that losing the AGE private key means the encrypted vault cannot be recovered and that there is no reset or backdoor. source
- License and support
- PX Secrets is licensed under AGPL-3.0, with bug reports handled through GitHub Issues and questions and ideas through GitHub Discussions. source
- Local API
- A local API lets scripts and AI agents retrieve secrets at runtime, and the app can run headlessly as a background service. source
- Optional authentication
- Setting PX_SECRETS_AUTH_TOKEN requires a bearer token for API requests, and read-only mode can disable mutating endpoints. source
- Privacy
- The project states it makes no network calls and collects no telemetry, analytics, usage tracking, or crash reports. source
- Purpose
- PX Secrets is a free, open-source secrets manager that stores an encrypted vault on the user's machine. source
- Requirements and platforms
- The stated requirements are Python 3.9+, SOPS, and AGE; macOS and Linux are listed as supported, while Windows may work but is untested. source
- Temporary data
- The README says decrypted data is held in memory and temporary plaintext files are deleted after encryption. source
Checked against the maker's pages on 9 Oct 2026.