# justlovemaki/aiclient2api architecture

> Architecture diagram of the GitHub repository justlovemaki/aiclient2api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/justlovemaki/aiclient2api
- Repository: https://github.com/justlovemaki/aiclient2api

## Overview

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: [`src/services/api-manager.js`](https://github.com/justlovemaki/aiclient2api/blob/main/src/services/api-manager.js) (API Routing), [`src/services/ui-manager.js`](https://github.com/justlovemaki/aiclient2api/blob/main/src/services/ui-manager.js) (UI API Router), [`src/handlers/request-handler.js`](https://github.com/justlovemaki/aiclient2api/blob/main/src/handlers/request-handler.js) (Request Handler), [`src/services/service-manager.js`](https://github.com/justlovemaki/aiclient2api/blob/main/src/services/service-manager.js) (Service Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gateway["API Gateway"]
  node_request["Request Handler<br/>[request-handler.js]"]
  node_api["API Routing<br/>[api-manager.js]"]
  node_conversion["Format Conversion<br/>[convert.js]"]
  node_converter["Converter Strategies"]
  node_config["Configuration<br/>[config-manager.js]"]
end

subgraph group_providers["Provider Runtime"]
  node_service["Service Manager<br/>[service-manager.js]"]
  node_pool["Provider Pools"]
  node_adapter["Provider Adapter<br/>[adapter.js]"]
  node_providercores["Provider Cores"]
  node_models["Model Registry<br/>[provider-models.js]"]
end

subgraph group_management["Management UI"]
  node_uimanager["UI API Router<br/>[ui-manager.js]"]
  node_uiauth["Console Authentication<br/>[auth.js]"]
  node_uimodules["Console APIs"]
  node_frontend["Admin Console"]
  node_oauth["OAuth Routes<br/>[oauth-api.js]"]
  node_authhandlers["OAuth Handlers<br/>[oauth-handlers.js]"]
end

subgraph group_extensions["Extensions and Usage"]
  node_plugins["Plugin Manager<br/>[plugin-manager.js]"]
  node_stats["Usage Statistics"]
  node_potluck["API Potluck"]
  node_events["Event Broadcast<br/>[event-broadcast.js]"]
end

node_client(("API Client"))
node_uiuser(("Console User"))

node_client -->|"sends requests"| node_request
node_request -->|"routes requests"| node_api
node_api -->|"converts formats"| node_conversion
node_api -->|"selects service"| node_service
node_api -->|"uses configuration"| node_config
node_conversion -->|"dispatches conversion"| node_converter
node_service -->|"initializes pools"| node_pool
node_service -->|"creates adapters"| node_adapter
node_pool -->|"gets adapters"| node_adapter
node_pool -->|"converts data"| node_conversion
node_adapter -->|"dispatches providers"| node_providercores
node_api -->|"lists models"| node_models
node_uiuser -->|"uses console"| node_uimanager
node_uimanager -->|"checks authentication"| node_uiauth
node_uimanager -->|"routes API calls"| node_uimodules
node_uimanager -->|"uses plugin manager"| node_plugins
node_uimanager -->|"registers module"| node_events
node_frontend -.->|"calls console APIs"| node_uimodules
node_oauth -->|"invokes handlers"| node_authhandlers
node_request -->|"uses plugin manager"| node_plugins
node_stats -->|"checks authorization"| node_uiauth
node_potluck -.->|"provides API access"| node_client

click node_request "https://github.com/justlovemaki/aiclient2api/blob/main/src/handlers/request-handler.js"
click node_api "https://github.com/justlovemaki/aiclient2api/blob/main/src/services/api-manager.js"
click node_conversion "https://github.com/justlovemaki/aiclient2api/blob/main/src/convert/convert.js"
click node_converter "https://github.com/justlovemaki/aiclient2api/tree/main/src/converters/strategies"
click node_config "https://github.com/justlovemaki/aiclient2api/blob/main/src/core/config-manager.js"
click node_service "https://github.com/justlovemaki/aiclient2api/blob/main/src/services/service-manager.js"
click node_pool "https://github.com/justlovemaki/aiclient2api/blob/main/src/providers/provider-pool-manager.js"
click node_adapter "https://github.com/justlovemaki/aiclient2api/blob/main/src/providers/adapter.js"
click node_providercores "https://github.com/justlovemaki/aiclient2api/tree/main/src/providers"
click node_models "https://github.com/justlovemaki/aiclient2api/blob/main/src/providers/provider-models.js"
click node_uimanager "https://github.com/justlovemaki/aiclient2api/blob/main/src/services/ui-manager.js"
click node_uiauth "https://github.com/justlovemaki/aiclient2api/blob/main/src/ui-modules/auth.js"
click node_uimodules "https://github.com/justlovemaki/aiclient2api/tree/main/src/ui-modules"
click node_frontend "https://github.com/justlovemaki/aiclient2api/blob/main/static/app/provider-manager.js"
click node_oauth "https://github.com/justlovemaki/aiclient2api/blob/main/src/ui-modules/oauth-api.js"
click node_authhandlers "https://github.com/justlovemaki/aiclient2api/blob/main/src/auth/oauth-handlers.js"
click node_plugins "https://github.com/justlovemaki/aiclient2api/blob/main/src/core/plugin-manager.js"
click node_stats "https://github.com/justlovemaki/aiclient2api/tree/main/src/plugins/model-usage-stats"
click node_potluck "https://github.com/justlovemaki/aiclient2api/tree/main/src/plugins/api-potluck"
click node_events "https://github.com/justlovemaki/aiclient2api/blob/main/src/ui-modules/event-broadcast.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_request,node_api,node_conversion,node_converter,node_config,node_client,node_uiuser toneBlue
class node_service,node_pool,node_adapter,node_providercores,node_models toneAmber
class node_uimanager,node_uiauth,node_uimodules,node_frontend,node_oauth,node_authhandlers toneMint
class node_plugins,node_stats,node_potluck,node_events toneRose
```

## Components

### API Gateway

- [Request Handler](https://github.com/justlovemaki/aiclient2api/blob/main/src/handlers/request-handler.js): `src/handlers/request-handler.js`
- [API Routing](https://github.com/justlovemaki/aiclient2api/blob/main/src/services/api-manager.js): `src/services/api-manager.js`
- [Format Conversion](https://github.com/justlovemaki/aiclient2api/blob/main/src/convert/convert.js): `src/convert/convert.js`
- [Converter Strategies](https://github.com/justlovemaki/aiclient2api/tree/main/src/converters/strategies): `src/converters/strategies`
- [Configuration](https://github.com/justlovemaki/aiclient2api/blob/main/src/core/config-manager.js): `src/core/config-manager.js`

### Provider Runtime

- [Service Manager](https://github.com/justlovemaki/aiclient2api/blob/main/src/services/service-manager.js): `src/services/service-manager.js`
- [Provider Pools](https://github.com/justlovemaki/aiclient2api/blob/main/src/providers/provider-pool-manager.js): `src/providers/provider-pool-manager.js`
- [Provider Adapter](https://github.com/justlovemaki/aiclient2api/blob/main/src/providers/adapter.js): `src/providers/adapter.js`
- [Provider Cores](https://github.com/justlovemaki/aiclient2api/tree/main/src/providers): `src/providers`
- [Model Registry](https://github.com/justlovemaki/aiclient2api/blob/main/src/providers/provider-models.js): `src/providers/provider-models.js`

### Management UI

- [UI API Router](https://github.com/justlovemaki/aiclient2api/blob/main/src/services/ui-manager.js): `src/services/ui-manager.js`
- [Console Authentication](https://github.com/justlovemaki/aiclient2api/blob/main/src/ui-modules/auth.js): `src/ui-modules/auth.js`
- [Console APIs](https://github.com/justlovemaki/aiclient2api/tree/main/src/ui-modules): `src/ui-modules`
- [Admin Console](https://github.com/justlovemaki/aiclient2api/blob/main/static/app/provider-manager.js): `static/app/provider-manager.js`
- [OAuth Routes](https://github.com/justlovemaki/aiclient2api/blob/main/src/ui-modules/oauth-api.js): `src/ui-modules/oauth-api.js`
- [OAuth Handlers](https://github.com/justlovemaki/aiclient2api/blob/main/src/auth/oauth-handlers.js): `src/auth/oauth-handlers.js`

### Extensions and Usage

- [Plugin Manager](https://github.com/justlovemaki/aiclient2api/blob/main/src/core/plugin-manager.js): `src/core/plugin-manager.js`
- [Usage Statistics](https://github.com/justlovemaki/aiclient2api/tree/main/src/plugins/model-usage-stats): `src/plugins/model-usage-stats`
- [API Potluck](https://github.com/justlovemaki/aiclient2api/tree/main/src/plugins/api-potluck): `src/plugins/api-potluck`
- [Event Broadcast](https://github.com/justlovemaki/aiclient2api/blob/main/src/ui-modules/event-broadcast.js): `src/ui-modules/event-broadcast.js`

### Other components

- **API Client**
- **Console User**

## Connections

- API Client → Request Handler: sends requests (evidence: `README.md`)
- Request Handler → API Routing: routes requests (evidence: `src/handlers/request-handler.js`)
- API Routing → Format Conversion: converts formats (evidence: `src/services/api-manager.js`)
- API Routing → Service Manager: selects service (evidence: `src/services/api-manager.js`)
- API Routing → Configuration: uses configuration (evidence: `src/services/api-manager.js`)
- Format Conversion → Converter Strategies: dispatches conversion (evidence: `src/convert/convert.js`)
- Service Manager → Provider Pools: initializes pools (evidence: `src/services/service-manager.js`)
- Service Manager → Provider Adapter: creates adapters (evidence: `src/services/service-manager.js`)
- Provider Pools → Provider Adapter: gets adapters (evidence: `src/providers/provider-pool-manager.js`)
- Provider Pools → Format Conversion: converts data (evidence: `src/providers/provider-pool-manager.js`)
- Provider Adapter → Provider Cores: dispatches providers (evidence: `src/providers/adapter.js`)
- API Routing → Model Registry: lists models
- Console User → UI API Router: uses console (evidence: `README.md`)
- UI API Router → Console Authentication: checks authentication (evidence: `src/services/ui-manager.js`)
- UI API Router → Console APIs: routes API calls (evidence: `src/services/ui-manager.js`)
- UI API Router → Plugin Manager: uses plugin manager (evidence: `src/services/ui-manager.js`)
- UI API Router → Event Broadcast: registers module (evidence: `src/services/ui-manager.js`)
- Admin Console → Console APIs: calls console APIs
- OAuth Routes → OAuth Handlers: invokes handlers (evidence: `src/ui-modules/oauth-api.js`)
- Request Handler → Plugin Manager: uses plugin manager (evidence: `src/handlers/request-handler.js`)
- Usage Statistics → Console Authentication: checks authorization (evidence: `src/plugins/model-usage-stats/api-routes.js`)
- API Potluck → API Client: provides API access
