proxy

A personal AI gateway with a dark account-pool dashboard. Based on CLIProxyAPI, with the original Go proxy engine and protocol compatibility.

Start locally

Requires Go 1.26+ and OpenSSL. From this repository:

./scripts/start.sh

On first start, the script generates a local-only config.yaml, a management key, and a client API key. Find the keys in .proxy-local-credentials (owner-readable and ignored by Git). Open http://127.0.0.1:8317/management.html, click Connect, and enter the management key. Subsequent starts preserve your configuration.

Import credential JSON through Manage, or use Provider sign-in to open the upstream OAuth panel. Your API base URL is http://127.0.0.1:8317/v1; use the client API key for API requests. Provider accounts are not preconfigured.

Dashboard

• Overview: account pools, provider filters, search, reported allowance windows, reset times, and account status.
• Manage: import credential JSON and enable or pause account routing.
• Logs: filter the latest 300 server log lines.
• Settings: change file logging, usage statistics, and routing strategy.
• Advanced panel: OAuth sign-in, API keys, model aliases, and other upstream configuration at /management.html?panel=upstream&safe-mode=configure.

The dashboard is embedded in the Go binary. Upstream panel updates cannot overwrite it. Open internal/api/ui/management.html directly for an offline design preview, or append ?demo=1 to the server dashboard URL. Preview accounts are fictional and preview mode cannot mutate your server.

Quotas come from reported Codex/Claude headers or supported quota providers/probes. Missing quotas display “Not reported”; values may be stale until providers report new observations. Provider totals sum the preferred (weekly where available) allowance per enabled, reporting account; they are account percentages, not interchangeable token balances. Request totals are successful requests reported by the server, not active requests. Management keys stay in browser memory and clear on reload/disconnect.

Development

go build -o proxy ./cmd/server
node --test scripts/test-ui.mjs
go test ./internal/api ./internal/api/handlers/management ./internal/managementasset

Edit internal/api/ui/management.html and rebuild to update the bundled dashboard. The UI has no npm dependencies or external assets. Go module identifiers remain upstream-compatible so updates and SDK imports stay straightforward.

See upstream documentation for providers, CLI flags, Docker, and detailed configuration. The upstream MIT license and attribution are retained in LICENSE.