Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

PX Secrets

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
  • API
  • Self-hosted
7.8 Club score Visit github.com

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

PX Secrets

Free

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.