Official Skill, full functionality
From models, accounts and routes to request diagnostics, quota management and daily operations, agents access SmartAPI’s full management capabilities through the official Skill.
Install the official Skill →English
OPEN SOURCE · SELF-HOSTED · AI GATEWAY
SmartAPI
Self-hosted AI gateway
Connect your clients to the accounts you already have. SmartAPI handles routing, waiting and recoverable failures.
Go + SQLite · AMD64 / ARM64 · Apache-2.0
01 / AI FIRST
AI First
Logical models: built around your business
Define model endpoints for your business. Change upstream models, accounts and routes inside SmartAPI while keeping your application configuration unchanged.
Configure logical models →02 / PERFORMANCE
Extreme Performance
Lower memory usage
Peak working set: 30.8–34.5 MiB. About 49%–55% lower than CLIProxyAPI and 92%–93% lower than the sub2api stack in this benchmark.
Lower CPU usage
SmartAPI’s peak CPU usage is close to CLIProxyAPI and lower than the sub2api stack: 146.6%–157.1%, 151.0%–151.2% and 390.2%–406.3%, respectively.
Same-source baseline, not a 1.0.0 release-image test · OpenAI Chat Mock · ARM64 · concurrency 32 · 1 KiB / 64 KiB responses · 2026-10-30. Methods & full data →
03 / RELIABILITY
Reliable Requests
Automatic failover
When the primary upstream fails, automatically try a compatible fallback.
Configurable switching policies
Choose when to wait or switch using time windows, first-output timeouts and failure types.
Configure switching policies →Queue requests, see fewer 429s
Wait within configured budgets when capacity is unavailable, then continue when it opens.
Automatic resets and quota protection
Automatically redeem available Codex reset credits and reduce requests to exhausted accounts.
Configure AutoReset →GET STARTED
Two commands to start.
Create the administrator, add an upstream and issue a client key. No source build or separate database is required.
Installation, backups and upgrades →TERMINAL
curl -fsSLo compose.yaml https://github.com/hulkbig/smartapi/releases/latest/download/compose.yaml
docker compose up -d --no-buildOpen localhost:17910 to initialize.
Before you start
Does SmartAPI include accounts or credits?
No. Use your own API keys or supported subscriptions. Calls, retries and capability probes can incur upstream charges.
Will Thinking continue until success?
Waiting is bounded by recovery budgets. A client’s Thinking display is not evidence of continuous upstream reasoning.
Are all combinations verified?
No. Some account drivers have offline coverage only. Verify tools, streaming and follow-up turns on your own routes.