- The proxy is stateless and env-configured; the 'main' volume is no longer mounted into the container (config.json is read host-side) - README/instructions note that backups contain the saved API key - Upstream tagged v0.3.2 (matches package.json); submodule checked out at the tag Verified on the StartOS 0.4.0 VM: update installs over the previous version, keeps the saved key, and reports attestation-verified health. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1.9 KiB
PPQ Private Mode
Documentation
- Upstream proxy documentation — endpoints, client examples, and how the encryption works
- PPQ.AI API docs — creating an API key and funding your account
Getting set up
- When the service is installed, you will be prompted to run Configure PPQ API Key. Paste an API key from ppq.ai (create one under Settings → API Keys and fund the account — usage is billed per query to this key).
- The service starts and performs a cryptographic attestation of the remote enclave. The health check reports ready once attestation is verified — usually within a few seconds.
- Copy the OpenAI-Compatible API address from the service's interface panel. That is the URL you point your AI clients at.
Using the proxy
Point any OpenAI-compatible client at the interface address:
POST <api-address>/v1/chat/completions
{"model": "private/glm-5-2", "messages": [{"role": "user", "content": "Hello"}]}
Anthropic-SDK clients (including Claude Code) can use the native endpoint at
<api-address>/v1/messages. For Claude Code, set:
export ANTHROPIC_BASE_URL="<api-address>"
export ANTHROPIC_MODEL="private/glm-5-2"
GET <api-address>/v1/models lists the available private models. Every
request is encrypted on your server before it leaves and is only decrypted
inside the attested enclave — neither PPQ.AI nor the model host can read your
queries.
Requests are billed to your saved API key by default. To bill a different
PPQ.AI key per request, pass it as an Authorization: Bearer header.
If you need to change the key or turn on verbose logging later, run Configure PPQ API Key again from the service's Actions.
Backups of this service include your saved API key, and restoring a backup restores it — keep that in mind when handling backup drives.