aimod-cc/Agent2API

▲ 52 stars today★ 2,218⑂ 585

Local AI routing gateway with Agent client takeover — reuse existing client logins, call 50+ AI clients through one base URL, with unified OpenAI / Anthropic / Images APIs, multi-account routing

About aimod-cc/Agent2API

aimod-cc/Agent2API is an open-source project on GitHub, mainly written in Rust. Local AI routing gateway with Agent client takeover — reuse existing client logins, call 50+ AI clients through one base URL It currently holds 2,218 stars and 585 forks with 144 open issues, and was last pushed on 2026-11-09 (repository created 2026-09-11).

Project Overview

Git Homed tracks it on the Today's Trending board, currently at rank #83 with 52 new stars today.

GitHub Repository Details

Repository aimod-cc/Agent2API · default branch main · size 49688 KB · watchers 3 · source: GitHub REST API and repository README

README

Agent2API

An AI routing gateway with Agent client takeover, unifying model APIs and local client configuration

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Português (BR)

license release docker pulls stars platform

✨ Key Features • 💬 Community & Support • 🚀 Quick Start • 📦 Installation & deployment • 📸 Screenshots • 🔧 Development & Build • 📜 Usage Notice

---

Agent2API is an AI routing gateway with Agent client takeover. It exposes a unified model API for custom AI providers and centralizes account routing, model mapping, gateway keys and request reports. It also manages local Agent clients' connection profiles, including importing, switching and previewing configuration changes.

✨ Key Features

❤️ Sponsors

https://github.com/aimod-cc/Agent2API/blob/HEAD/ProxyLane (sponsor)

https://github.com/aimod-cc/Agent2API/blob/HEAD/ProxyLane Thanks to ProxyLane for sponsoring this project! ProxyLane provides native static residential ISP proxies for AI accounts (Static Residential ISP): IPs come from real home broadband operators with low Scamalytics fraud scores, each IP is dedicated to you, with unlimited traffic, from $3.90. Add one exit per account on the Network proxy page. Use code AGENT2API25 for 25% off your first purchase.

💬 Community & Support

🚀 Quick start

Three forms — pick the one that matches your setup; the complete install, upgrade, uninstall and troubleshooting guide is in Installation & deployment.

| Form | Artifact | Interface | | --- | --- | --- | | Desktop (Windows / macOS / Linux) | Agent2API__x64-setup.exe, _universal.dmg, _amd64.deb, _amd64.AppImage | App window | | Server (Windows Server / Linux, headless) | agent2api-server-windows-amd64.zip, agent2api-server-linux-.tar.gz | Browser panel | | Docker | aimodcc/agent2api:latest (amd64 / arm64) | Browser panel |

Desktop: add a custom provider and account, create a gateway key, then apply a connection profile on the Agent page or configure your client with http://127.0.0.1:3065/v1 and that key. Additional provider capabilities require the corresponding plugin.

Server (no GUI; registered as a system service and started at boot):

# Linux
tar -xzf agent2api-server-linux-amd64.tar.gz && cd agent2api-server-linux-amd64 && sudo bash install.sh
# Windows Server (administrator PowerShell)
Expand-Archive agent2api-server-windows-amd64.zip -DestinationPath C:\agent2api-pkg
cd C:\agent2api-pkg; .\install-service.ps1

Docker:

docker run -d --name agent2api --restart unless-stopped -p 3065:3065 -v ./data:/data aimodcc/agent2api:latest

Whichever form you pick, open the panel afterwards (http://127.0.0.1:3065/; use the host IP for the server and Docker forms), register the admin account, then create a key on the "Gateway Keys" page. Connectivity check: curl http://127.0.0.1:3065/health

Mobile: open http://:3065/m in a browser (you can "Add to Home Screen" for a full-screen PWA). For a standalone icon, install Agent2API-.apk (Android) or Agent2API-.ipa (iOS, unsigned — re-sign it yourself) from the Release. Details: Install & deploy → Mobile.

📸 Screenshots

Accounts

Accounts page: global queue, per-model rate-limit cooldown, expiry and balance

Add account:

Add account: choose provider and edition, then sign in on the web

Model management

Model management: per-provider model catalog with rate, context and mappings

Report

Overview: requests / success rate / tokens / top model, with account and provider rankings, usage donuts and a 365-day activity heatmap:

Report overview: stat cards, top accounts / providers, model and provider usage donuts

Trends: 24-hour cache hit rate (line) and token consumption (area) on twin axes, with a per-day token bar chart below:

Report trends: dual-axis cache hit rate and token consumption, per-day token bars

🔧 Development & Build

Requirements

Common scripts

npm run tauri:install      # Install desktop dependencies (same as npm --prefix desktop-tauri install)
npm run tauri:dev          # Launch the desktop app in dev mode (with hot reload)
npm run tauri:build        # Build the desktop installer

npm run build:icon # Generate the icon source image (run after changing the icon design, then run tauri icon)

The build artifact is target/release/bundle/nsis/Agent2API__x64-setup.exe (about 8.6 MB as of 3.0; src-tauri/.cargo/config.toml points cargo's target-dir at the project root's target/).

The macOS .dmg can only be built on macOS (npm --prefix desktop-tauri run build -- --target universal-apple-darwin) — it cannot be cross-compiled from Windows, so the official artifact comes from the CI build workflow (macos-latest, two targets merged). Docker images and the server archives used for in-container updates come from the same workflow's linux-server job, which reuses the Dockerfile's compile path so the executable inside is built from the same toolchain as the image.

📜 Usage Notice

Credential and data security

Account credentials are encrypted in the local database, but exports, backups and key files may still contain sensitive data. Keep them private; do not upload them to public repositories or cloud storage, or share them with others.

No warranty

The project is provided "as is", without guarantees of availability, stability, security or suitability for a particular purpose. Trademarks and services belong to their respective owners. The complete license and warranty terms are in LICENSE.

📄 License

This project uses the same GNU Affero General Public License v3.0 (AGPL-3.0) as the provider plugin repository. Use, modification and distribution, including commercial use, are permitted under the license. Preserve copyright and license notices and fulfill applicable source-code obligations. If you offer a modified version over a network, you must offer its Corresponding Source to those users.

⭐ Star History

https://github.com/aimod-cc/Agent2API/blob/HEAD/Star History Chart

Download the latest release • Report an issue

If this project helps you, a ⭐️ Star is appreciated!

GitHub Stars & Activity

2,218Stars
585Forks
144Open issues
RustLanguage

GitHub Popularity

GitHub stars2,218
Forks585
Open issues144
Primary languageRust
LicenseAGPL-3.0
Stars gained today52
Created2026-09-11
Last pushed2026-11-09

Trending History

Daily boardrank #83 · ▲ 52 stars

Related GitHub Projects

1

farion1231 / cc-switch

Rust★ 155,112⑂ 10,154▲ 312 stars
→
2

pbakaus / impeccable

Rust★ 111,729⑂ 6,673▲ 693 stars
→
3

rustfs / rustfs

Rust★ 36,197⑂ 1,679▲ 55 stars
→
4

t8y2 / dbx

Rust★ 30,593⑂ 2,785▲ 101 stars
→
5

PrimeIntellect-ai / prime-agent

Rust★ 22,795⑂ 2,530▲ 67 stars
→
6

anomalyco / hex

Rust★ 7,199⑂ 469▲ 198 stars
→
7

NVIDIA-NeMo / Switchyard

Rust★ 3,616⑂ 374▲ 41 stars
→
8

BurntSushi / jiff

Rust★ 3,116⑂ 141▲ 61 stars
→

More Trending Repositories