Documentation
¶
Overview ¶
Command proxy is the lean, Apache-2.0 FinOps Proxy engine.
It runs the circuit-breaker reverse proxy from the public core module: a HashDetector for loop detection, a static (or remotely refreshed) price table, an in-memory or SQLite store, per-key budgets from an optional keys file, and standardized JSON logging to stdout. No enterprise dependency is pulled in — this is the whole open-source core in one binary.
Usage:
proxy -upstream http://localhost:11434/v1 proxy -upstream https://api.openai.com -db ./finops.db -keys ./keys.json
The proxy answers GET /healthz locally; every other request is hashed, loop-checked, budget-checked, and forwarded upstream.
Click to show internal directories.
Click to hide internal directories.