How justlovemaki/aiclient2api works
AIClient2API is a local gateway that presents client-only AI services through a unified OpenAI-compatible API, with a management console for configuration and provider administration. The main request path is client → request handling/API routing → conversion and service selection → provider-specific adapters. Authentication/OAuth, provider pools, plugins, and usage features are distinct supporting capabilities. Edges reflect the README, excerpts, or SOURCE INDEX references; unsampled modules are represented at their known paths, with uncertain wiring omitted.
Main entry points: api-manager.js API Routing · ui-manager.js UI API Router · request-handler.js Request Handler · service-manager.js Service Manager
Components 22
API Gateway
- Request Handler
src/handlers/request-handler.js - API Routing
src/services/api-manager.js - Format Conversion
src/convert/convert.js - Converter Strategies
src/converters/strategies - Configuration
src/core/config-manager.js
Provider Runtime
- Service Manager
src/services/service-manager.js - Provider Pools
src/providers/provider-pool-manager.js - Provider Adapter
src/providers/adapter.js - Provider Cores
src/providers - Model Registry
src/providers/provider-models.js
Management UI
- UI API Router
src/services/ui-manager.js - Console Authentication
src/ui-modules/auth.js - Console APIs
src/ui-modules - Admin Console
static/app/provider-manager.js - OAuth Routes
src/ui-modules/oauth-api.js - OAuth Handlers
src/auth/oauth-handlers.js
Extensions and Usage
- Plugin Manager
src/core/plugin-manager.js - Usage Statistics
src/plugins/model-usage-stats - API Potluck
src/plugins/api-potluck - Event Broadcast
src/ui-modules/event-broadcast.js
Other components
- API Client
- Console User
Connections 22
- API Client → Request Handler: sends requests
README.md - Request Handler → API Routing: routes requests
src/handlers/request-handler.js - API Routing → Format Conversion: converts formats
src/services/api-manager.js - API Routing → Service Manager: selects service
src/services/api-manager.js - API Routing → Configuration: uses configuration
src/services/api-manager.js - Format Conversion → Converter Strategies: dispatches conversion
src/convert/convert.js - Service Manager → Provider Pools: initializes pools
src/services/service-manager.js - Service Manager → Provider Adapter: creates adapters
src/services/service-manager.js - Provider Pools → Provider Adapter: gets adapters
src/providers/provider-pool-manager.js - Provider Pools → Format Conversion: converts data
src/providers/provider-pool-manager.js - Provider Adapter → Provider Cores: dispatches providers
src/providers/adapter.js - API Routing → Model Registry: lists models
- Console User → UI API Router: uses console
README.md - UI API Router → Console Authentication: checks authentication
src/services/ui-manager.js - UI API Router → Console APIs: routes API calls
src/services/ui-manager.js - UI API Router → Plugin Manager: uses plugin manager
src/services/ui-manager.js - UI API Router → Event Broadcast: registers module
src/services/ui-manager.js - Admin Console → Console APIs: calls console APIs
- OAuth Routes → OAuth Handlers: invokes handlers
src/ui-modules/oauth-api.js - Request Handler → Plugin Manager: uses plugin manager
src/handlers/request-handler.js - Usage Statistics → Console Authentication: checks authorization
src/plugins/model-usage-stats/api-routes.js - API Potluck → API Client: provides API access