How aimod-cc/agent2api works
Agent2API is a local multi-provider AI gateway packaged with a Tauri desktop application. An OpenAI-compatible client sends chat requests to the local HTTP server; the gateway resolves the requested model, selects eligible accounts in global priority order, adapts and forwards requests to provider services, and returns the response. The desktop UI manages accounts, models, keys, settings, tasks, and reports. The README documents the end-to-end behavior; source excerpts and the SOURCE INDEX clarify pipeline, catalog, persistence, and scheduled-task responsibilities. Unsampled implementation details are represented only where documented.
Main entry points: pipeline.rs Request pipeline · http.rs HTTP server · catalog.rs Model catalog · provider_loop.rs Upstream forwarding
Components 21
Gateway runtime
- HTTP server
desktop-tauri/src-tauri/server/src/server/http.rs - Chat API routes
desktop-tauri/src-tauri/server/src/server/api/chat.rs - Request pipeline
desktop-tauri/src-tauri/server/src/server/api/pipeline.rs - Model catalog
desktop-tauri/src-tauri/server/src/server/core/providers/catalog.rs - Model rules
desktop-tauri/src-tauri/server/src/server/core/model_rules/mod.rs - Upstream forwarding
desktop-tauri/src-tauri/server/src/server/core/upstream/provider_loop.rs
Accounts and providers
- Account routing
desktop-tauri/src-tauri/server/src/server/core/routing.rs - Account store
desktop-tauri/src-tauri/server/src/server/core/account_store/store_crud.rs - Provider adapters
desktop-tauri/src-tauri/server/src/server/core/providers/adapter.rs - Login and credentials
desktop-tauri/src-tauri/server/src/server/core/login.rs
Management and persistence
- Gateway configuration
desktop-tauri/src-tauri/server/src/server/config/mod.rs - SQLite database
desktop-tauri/src-tauri/server/src/server/db/mod.rs - Scheduled tasks
desktop-tauri/src-tauri/server/src/server/core/scheduled_tasks.rs - Request statistics
desktop-tauri/src-tauri/server/src/server/request_stats.rs - Runtime logging
desktop-tauri/src-tauri/server/src/server/logging.rs
Desktop interface
- Account management
desktop-tauri/ui-islands/src/islands/accounts-page.tsx - Model management
desktop-tauri/ui-islands/src/islands/models-page.tsx - Settings and tasks
desktop-tauri/ui-islands/src/islands/settings-page.tsx - Usage reports
desktop-tauri/ui-islands/src/islands/report-page.tsx
Other components
- OpenAI client
- AI providers
Connections 21
- OpenAI client → HTTP server: sends requests
- HTTP server → Chat API routes: routes chat
- Chat API routes → Request pipeline: processes request
desktop-tauri/src-tauri/server/src/server/api/pipeline.rs - Request pipeline → Model catalog: resolves model
desktop-tauri/src-tauri/server/src/server/api/pipeline.rs - Model catalog → Model rules: applies overrides
desktop-tauri/src-tauri/server/src/server/core/providers/catalog.rs - Request pipeline → Account routing: selects candidates
- Account routing → Account store: reads accounts
desktop-tauri/src-tauri/server/src/server/core/routing.rs - Upstream forwarding → Provider adapters: builds provider requests
desktop-tauri/src-tauri/server/src/server/core/providers/adapter.rs - Upstream forwarding → AI providers: forwards requests
- Request pipeline → Upstream forwarding: forwards chat
- Login and credentials → Account store: stores credentials
- Model catalog → Provider adapters: gets model listings
desktop-tauri/src-tauri/server/src/server/core/providers/catalog.rs - Gateway configuration → SQLite database: persists settings
desktop-tauri/src-tauri/server/src/server/config/mod.rs - Account store → SQLite database: persists accounts
- Scheduled tasks → Gateway configuration: reads task settings
desktop-tauri/src-tauri/server/src/server/core/scheduled_tasks.rs - Request pipeline → Request statistics: records requests
desktop-tauri/src-tauri/server/src/server/api/pipeline.rs - Request pipeline → Runtime logging: logs failures
desktop-tauri/src-tauri/server/src/server/api/pipeline.rs - Account management → HTTP server: manages accounts
- Model management → HTTP server: manages models
- Settings and tasks → HTTP server: configures gateway
- Usage reports → HTTP server: views reports