# fuzhengwei/waliapi architecture

> Architecture diagram of the GitHub repository fuzhengwei/waliapi, 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/fuzhengwei/waliapi
- Repository: https://github.com/fuzhengwei/waliapi

## Overview

WaLiAPI is a local LLM API gateway with desktop and web administration. Downstream clients send requests to the gateway; its handlers apply routing and proxy logic to reach configured model providers, with protocol adaptation for supported formats. The product also manages channels, API keys, provider authentication, request logs, knowledge-base RAG, Wiki, and MCP tools. The graph combines sampled routes and calls with README-documented capabilities; unsampled subsystem links are omitted or marked unverified rather than inferred as direct calls.

Main entry points: [`src-tauri/src/server/handlers.rs`](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/server/handlers.rs) (Request Handlers), [`src-tauri/src/server/router.rs`](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/server/router.rs) (HTTP Router), [`src-tauri/src/db/repository.rs`](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/db/repository.rs) (SQLite Repository), [`src-tauri/src/server/admin_routes.rs`](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/server/admin_routes.rs) (Admin API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Administration"]
  node_frontend["Desktop Admin UI<br/>[App.tsx]"]
  node_web_admin["Web Admin UI<br/>[App.tsx]"]
  node_admin_routes["Admin API<br/>[admin_routes.rs]"]
  node_admin_commands["Admin Commands"]
end

subgraph group_gateway["Gateway Runtime"]
  node_gateway_router["HTTP Router<br/>[router.rs]"]
  node_request_handlers["Request Handlers<br/>[handlers.rs]"]
  node_request_policy["Routing And Failover"]
  node_proxy["Upstream Proxy<br/>[proxy.rs]"]
  node_endpoint_exec["Endpoint Execution<br/>[driver.rs]"]
end

subgraph group_providers["Providers And Protocols"]
  node_protocols["Protocol Codecs"]
  node_adaptors["Provider Adaptors"]
  node_auth_service["Provider Accounts<br/>[service.rs]"]
end

subgraph group_knowledge["Knowledge Services"]
  node_knowledge["Knowledge RAG"]
  node_wiki["Wiki Engine<br/>[ingest.rs]"]
  node_mcp["MCP Tools<br/>[handlers.rs]"]
end

subgraph group_platform["State And Security"]
  node_database[("SQLite Repository<br/>[repository.rs]")]
  node_security["Security Controls"]
  node_settings[("Settings Store<br/>[settings_store.rs]")]
  node_logs["Audit And Usage Logs<br/>[audit_log.rs]"]
end

node_admin_user(("Administrator"))
node_clients(("API Clients"))
node_upstream(("Model Providers"))

node_admin_user -->|"configures"| node_frontend
node_admin_user -->|"manages"| node_web_admin
node_frontend -.->|"invokes admin API"| node_admin_routes
node_web_admin -.->|"uses admin API"| node_admin_routes
node_admin_routes -->|"dispatches commands"| node_admin_commands
node_clients -->|"sends requests"| node_gateway_router
node_gateway_router -->|"routes requests"| node_request_handlers
node_request_handlers -->|"uses routing"| node_request_policy
node_request_handlers -->|"calls proxy"| node_proxy
node_request_handlers -->|"uses executor"| node_endpoint_exec
node_request_handlers -->|"audits requests"| node_security
node_request_handlers -->|"reads and writes"| node_database
node_proxy -->|"forwards requests"| node_upstream
node_proxy -.->|"adapts provider traffic"| node_adaptors
node_protocols -.->|"translates formats"| node_adaptors
node_auth_service -->|"persists accounts"| node_database
node_admin_routes -.->|"dispatches auth operations"| node_auth_service
node_admin_commands -.->|"manages configuration"| node_database
node_gateway_router -->|"routes knowledge API"| node_knowledge
node_gateway_router -->|"routes Wiki API"| node_wiki
node_gateway_router -->|"routes MCP API"| node_mcp
node_knowledge -.->|"stores knowledge data"| node_database
node_wiki -->|"calls proxy for ingestion"| node_proxy
node_wiki -->|"reads and writes"| node_database
node_mcp -->|"queries RAG"| node_knowledge
node_mcp -->|"uses Wiki services"| node_wiki
node_gateway_router -->|"configures service"| node_settings
node_request_handlers -.->|"records request activity"| node_logs

click node_frontend "https://github.com/fuzhengwei/waliapi/blob/main/src/App.tsx"
click node_web_admin "https://github.com/fuzhengwei/waliapi/blob/main/web/src/App.tsx"
click node_admin_routes "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/server/admin_routes.rs"
click node_admin_commands "https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/commands"
click node_gateway_router "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/server/router.rs"
click node_request_handlers "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/server/handlers.rs"
click node_request_policy "https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/core"
click node_proxy "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/core/proxy.rs"
click node_endpoint_exec "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/endpoint_executor/driver.rs"
click node_protocols "https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/protocol/codec"
click node_adaptors "https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/adaptor"
click node_auth_service "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/auth_provider/service.rs"
click node_knowledge "https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/services/knowledge"
click node_wiki "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/services/wiki/ingest.rs"
click node_mcp "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/services/mcp/handlers.rs"
click node_database "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/db/repository.rs"
click node_security "https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/security"
click node_settings "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/settings_store.rs"
click node_logs "https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/audit_log.rs"

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_frontend,node_web_admin,node_admin_routes,node_admin_commands,node_clients toneBlue
class node_gateway_router,node_request_handlers,node_request_policy,node_proxy,node_endpoint_exec toneAmber
class node_protocols,node_adaptors,node_auth_service toneMint
class node_knowledge,node_wiki,node_mcp toneRose
class node_database,node_security,node_settings,node_logs,node_admin_user,node_upstream toneIndigo
```

## Components

### Administration

- [Desktop Admin UI](https://github.com/fuzhengwei/waliapi/blob/main/src/App.tsx): `src/App.tsx`
- [Web Admin UI](https://github.com/fuzhengwei/waliapi/blob/main/web/src/App.tsx): `web/src/App.tsx`
- [Admin API](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/server/admin_routes.rs): `src-tauri/src/server/admin_routes.rs`
- [Admin Commands](https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/commands): `src-tauri/src/commands`

### Gateway Runtime

- [HTTP Router](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/server/router.rs): `src-tauri/src/server/router.rs`
- [Request Handlers](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/server/handlers.rs): `src-tauri/src/server/handlers.rs`
- [Routing And Failover](https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/core): `src-tauri/src/core`
- [Upstream Proxy](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/core/proxy.rs): `src-tauri/src/core/proxy.rs`
- [Endpoint Execution](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/endpoint_executor/driver.rs): `src-tauri/src/endpoint_executor/driver.rs`

### Providers And Protocols

- [Protocol Codecs](https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/protocol/codec): `src-tauri/src/protocol/codec`
- [Provider Adaptors](https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/adaptor): `src-tauri/src/adaptor`
- [Provider Accounts](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/auth_provider/service.rs): `src-tauri/src/auth_provider/service.rs`

### Knowledge Services

- [Knowledge RAG](https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/services/knowledge): `src-tauri/src/services/knowledge`
- [Wiki Engine](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/services/wiki/ingest.rs): `src-tauri/src/services/wiki/ingest.rs`
- [MCP Tools](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/services/mcp/handlers.rs): `src-tauri/src/services/mcp/handlers.rs`

### State And Security

- [SQLite Repository](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/db/repository.rs): `src-tauri/src/db/repository.rs`
- [Security Controls](https://github.com/fuzhengwei/waliapi/tree/main/src-tauri/src/security): `src-tauri/src/security`
- [Settings Store](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/settings_store.rs): `src-tauri/src/settings_store.rs`
- [Audit And Usage Logs](https://github.com/fuzhengwei/waliapi/blob/main/src-tauri/src/audit_log.rs): `src-tauri/src/audit_log.rs`

### Other components

- **Administrator**
- **API Clients**
- **Model Providers**

## Connections

- Administrator → Desktop Admin UI: configures (evidence: `README.md`)
- Administrator → Web Admin UI: manages (evidence: `README.md`)
- Desktop Admin UI → Admin API: invokes admin API
- Web Admin UI → Admin API: uses admin API
- Admin API → Admin Commands: dispatches commands (evidence: `src-tauri/src/server/admin_routes.rs`)
- API Clients → HTTP Router: sends requests (evidence: `README.md`)
- HTTP Router → Request Handlers: routes requests (evidence: `src-tauri/src/server/router.rs`)
- Request Handlers → Routing And Failover: uses routing (evidence: `src-tauri/src/server/handlers.rs`)
- Request Handlers → Upstream Proxy: calls proxy (evidence: `src-tauri/src/server/handlers.rs`)
- Request Handlers → Endpoint Execution: uses executor (evidence: `src-tauri/src/server/handlers.rs`)
- Request Handlers → Security Controls: audits requests (evidence: `src-tauri/src/server/handlers.rs`)
- Request Handlers → SQLite Repository: reads and writes (evidence: `src-tauri/src/server/handlers.rs`)
- Upstream Proxy → Model Providers: forwards requests (evidence: `README.md`)
- Upstream Proxy → Provider Adaptors: adapts provider traffic (evidence: `src-tauri/src/core/proxy.rs`)
- Protocol Codecs → Provider Adaptors: translates formats
- Provider Accounts → SQLite Repository: persists accounts (evidence: `src-tauri/src/auth_provider/service.rs`)
- Admin API → Provider Accounts: dispatches auth operations
- Admin Commands → SQLite Repository: manages configuration
- HTTP Router → Knowledge RAG: routes knowledge API (evidence: `src-tauri/src/server/router.rs`)
- HTTP Router → Wiki Engine: routes Wiki API (evidence: `src-tauri/src/server/router.rs`)
- HTTP Router → MCP Tools: routes MCP API (evidence: `src-tauri/src/server/router.rs`)
- Knowledge RAG → SQLite Repository: stores knowledge data
- Wiki Engine → Upstream Proxy: calls proxy for ingestion (evidence: `src-tauri/src/services/wiki/ingest.rs`)
- Wiki Engine → SQLite Repository: reads and writes (evidence: `src-tauri/src/services/wiki/ingest.rs`)
- MCP Tools → Knowledge RAG: queries RAG (evidence: `src-tauri/src/services/mcp/handlers.rs`)
- MCP Tools → Wiki Engine: uses Wiki services (evidence: `src-tauri/src/services/mcp/handlers.rs`)
- HTTP Router → Settings Store: configures service (evidence: `src-tauri/src/server/router.rs`)
- Request Handlers → Audit And Usage Logs: records request activity
