# liuw1535/antigravity2api-nodejs architecture

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

## Overview

Antigravity2API is a server-side proxy that converts Google Antigravity requests and responses into OpenAI-, Gemini-, and Claude-compatible APIs. Its main workflow is an API client request entering the server and format-specific handlers, which use account/token management and the Antigravity client to obtain and stream or return a response. Separate branches provide SD WebUI compatibility and a web administration interface for accounts, quotas, and configuration. The README documents image generation, tools, structured output, and account rotation; source excerpts are partial, so uncertain internal dispatches are omitted.

Main entry points: [`src/server/index.js`](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/index.js) (HTTP server), [`src/api/client.js`](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/api/client.js) (API client), [`src/routes/admin.js`](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/admin.js) (Admin routes), [`src/auth/token_manager.js`](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/token_manager.js) (Token manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_serving["API serving"]
  node_api_client["API client<br/>[client.js]"]
  node_server["HTTP server<br/>[index.js]"]
  node_openai_route["OpenAI route<br/>[openai.js]"]
  node_gemini_route["Gemini route<br/>[gemini.js]"]
  node_claude_route["Claude route<br/>[claude.js]"]
  node_cli_route["CLI route<br/>[cli.js]"]
  node_sd_route["SD WebUI route<br/>[sd.js]"]
  node_openai_handler["OpenAI handler<br/>[openai.js]"]
  node_gemini_handler["Gemini handler<br/>[gemini.js]"]
  node_claude_handler["Claude handler<br/>[claude.js]"]
  node_geminicli_handler["CLI handler<br/>[geminicli.js]"]
end

subgraph group_upstream["Generation and conversion"]
  node_requester["API caller<br/>[client.js]"]
  node_geminicli_client["CLI client"]
  node_stream_parser["Stream parser<br/>[stream_parser.js]"]
  node_openai_converter["OpenAI converter<br/>[openai.js]"]
  node_claude_converter["Claude converter<br/>[claude.js]"]
  node_gemini_converter["Gemini converter<br/>[gemini.js]"]
end

subgraph group_accounts["Accounts and quotas"]
  node_token_manager["Token manager<br/>[token_manager.js]"]
  node_token_store[("Token store<br/>[token_store.js]")]
  node_quota_manager["Quota manager<br/>[quota_manager.js]"]
  node_geminicli_tokens["CLI token manager"]
end

subgraph group_admin["Administration"]
  node_admin_route["Admin routes<br/>[admin.js]"]
  node_oauth_manager["OAuth manager<br/>[oauth_manager.js]"]
end

subgraph group_runtime["Runtime support"]
  node_config["Configuration<br/>[config.js]"]
  node_image_storage[("Image storage<br/>[imageStorage.js]")]
  node_memory_manager["Memory manager<br/>[memoryManager.js]"]
  node_logger["Logger<br/>[logger.js]"]
  node_log_ws["Log WebSocket<br/>[logWsServer.js]"]
end

node_client_actor(("API client"))
node_admin_actor(("Administrator"))
node_antigravity["Google Antigravity"]

node_client_actor -->|"sends request"| node_server
node_server -->|"registers"| node_openai_route
node_server -->|"registers"| node_gemini_route
node_server -->|"registers"| node_claude_route
node_server -->|"registers"| node_cli_route
node_server -->|"registers"| node_sd_route
node_server -->|"registers"| node_admin_route
node_openai_route -.->|"dispatches"| node_openai_handler
node_gemini_route -.->|"dispatches"| node_gemini_handler
node_claude_route -.->|"dispatches"| node_claude_handler
node_cli_route -.->|"dispatches"| node_geminicli_handler
node_openai_handler -->|"calls"| node_api_client
node_claude_handler -->|"calls"| node_api_client
node_sd_route -->|"calls"| node_api_client
node_api_client -->|"selects accounts"| node_token_manager
node_api_client -->|"saves images"| node_image_storage
node_api_client -->|"sends generation request"| node_antigravity
node_api_client -->|"parses stream"| node_stream_parser
node_geminicli_handler -.->|"uses client"| node_geminicli_client
node_geminicli_client -->|"uses tokens"| node_geminicli_tokens
node_geminicli_client -->|"parses stream"| node_stream_parser
node_token_manager -->|"persists tokens"| node_token_store
node_token_manager -->|"checks quota"| node_quota_manager
node_admin_actor -->|"manages service"| node_admin_route
node_admin_route -->|"manages tokens"| node_token_manager
node_admin_route -->|"manages CLI tokens"| node_geminicli_tokens
node_admin_route -->|"reads quotas"| node_quota_manager
node_admin_route -->|"starts OAuth"| node_oauth_manager
node_admin_route -->|"updates settings"| node_config
node_config -->|"configures"| node_server
node_server -->|"starts cleanup"| node_memory_manager
node_server -->|"logs events"| node_logger
node_logger -->|"stores logs"| node_log_ws
node_api_client -->|"uses memory controls"| node_memory_manager

click node_api_client "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/api/client.js"
click node_server "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/index.js"
click node_openai_route "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/openai.js"
click node_gemini_route "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/gemini.js"
click node_claude_route "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/claude.js"
click node_cli_route "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/cli.js"
click node_sd_route "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/sd.js"
click node_openai_handler "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/handlers/openai.js"
click node_gemini_handler "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/handlers/gemini.js"
click node_claude_handler "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/handlers/claude.js"
click node_geminicli_handler "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/handlers/geminicli.js"
click node_requester "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/api/client.js"
click node_geminicli_client "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/api/geminicli_client.js"
click node_stream_parser "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/api/stream_parser.js"
click node_openai_converter "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/converters/openai.js"
click node_claude_converter "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/converters/claude.js"
click node_gemini_converter "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/converters/gemini.js"
click node_token_manager "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/token_manager.js"
click node_token_store "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/token_store.js"
click node_quota_manager "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/quota_manager.js"
click node_geminicli_tokens "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/geminicli_token_manager.js"
click node_admin_route "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/admin.js"
click node_oauth_manager "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/oauth_manager.js"
click node_config "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/config/config.js"
click node_image_storage "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/imageStorage.js"
click node_memory_manager "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/memoryManager.js"
click node_logger "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/logger.js"
click node_log_ws "https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/logWsServer.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_api_client,node_server,node_openai_route,node_gemini_route,node_claude_route,node_cli_route,node_sd_route,node_openai_handler,node_gemini_handler,node_claude_handler,node_geminicli_handler,node_client_actor toneBlue
class node_requester,node_geminicli_client,node_stream_parser,node_openai_converter,node_claude_converter,node_gemini_converter toneAmber
class node_token_manager,node_token_store,node_quota_manager,node_geminicli_tokens toneMint
class node_admin_route,node_oauth_manager toneRose
class node_config,node_image_storage,node_memory_manager,node_logger,node_log_ws,node_admin_actor,node_antigravity toneIndigo
```

## Components

### API serving

- [API client](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/api/client.js): `src/api/client.js`
- [HTTP server](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/index.js): `src/server/index.js`
- [OpenAI route](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/openai.js): `src/routes/openai.js`
- [Gemini route](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/gemini.js): `src/routes/gemini.js`
- [Claude route](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/claude.js): `src/routes/claude.js`
- [CLI route](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/cli.js): `src/routes/cli.js`
- [SD WebUI route](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/sd.js): `src/routes/sd.js`
- [OpenAI handler](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/handlers/openai.js): `src/server/handlers/openai.js`
- [Gemini handler](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/handlers/gemini.js): `src/server/handlers/gemini.js`
- [Claude handler](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/handlers/claude.js): `src/server/handlers/claude.js`
- [CLI handler](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/server/handlers/geminicli.js): `src/server/handlers/geminicli.js`

### Generation and conversion

- [API caller](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/api/client.js): `src/api/client.js`
- [CLI client](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/api/geminicli_client.js): `src/api/geminicli_client.js`
- [Stream parser](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/api/stream_parser.js): `src/api/stream_parser.js`
- [OpenAI converter](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/converters/openai.js): `src/utils/converters/openai.js`
- [Claude converter](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/converters/claude.js): `src/utils/converters/claude.js`
- [Gemini converter](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/converters/gemini.js): `src/utils/converters/gemini.js`

### Accounts and quotas

- [Token manager](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/token_manager.js): `src/auth/token_manager.js`
- [Token store](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/token_store.js): `src/auth/token_store.js`
- [Quota manager](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/quota_manager.js): `src/auth/quota_manager.js`
- [CLI token manager](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/geminicli_token_manager.js): `src/auth/geminicli_token_manager.js`

### Administration

- [Admin routes](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/routes/admin.js): `src/routes/admin.js`
- [OAuth manager](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/auth/oauth_manager.js): `src/auth/oauth_manager.js`

### Runtime support

- [Configuration](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/config/config.js): `src/config/config.js`
- [Image storage](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/imageStorage.js): `src/utils/imageStorage.js`
- [Memory manager](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/memoryManager.js): `src/utils/memoryManager.js`
- [Logger](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/logger.js): `src/utils/logger.js`
- [Log WebSocket](https://github.com/liuw1535/antigravity2api-nodejs/blob/main/src/utils/logWsServer.js): `src/utils/logWsServer.js`

### Other components

- **API client**
- **Administrator**
- **Google Antigravity**

## Connections

- API client → HTTP server: sends request (evidence: `README.md`)
- HTTP server → OpenAI route: registers (evidence: `src/server/index.js`)
- HTTP server → Gemini route: registers (evidence: `src/server/index.js`)
- HTTP server → Claude route: registers (evidence: `src/server/index.js`)
- HTTP server → CLI route: registers (evidence: `src/server/index.js`)
- HTTP server → SD WebUI route: registers (evidence: `src/server/index.js`)
- HTTP server → Admin routes: registers (evidence: `src/server/index.js`)
- OpenAI route → OpenAI handler: dispatches
- Gemini route → Gemini handler: dispatches
- Claude route → Claude handler: dispatches
- CLI route → CLI handler: dispatches
- OpenAI handler → API client: calls
- Claude handler → API client: calls (evidence: `src/server/handlers/claude.js`)
- SD WebUI route → API client: calls (evidence: `src/routes/sd.js`)
- API client → Token manager: selects accounts (evidence: `src/api/client.js`)
- API client → Image storage: saves images (evidence: `src/api/client.js`)
- API client → Google Antigravity: sends generation request (evidence: `src/api/client.js`)
- API client → Stream parser: parses stream (evidence: `src/api/client.js`)
- CLI handler → CLI client: uses client
- CLI client → CLI token manager: uses tokens (evidence: `src/api/geminicli_client.js`)
- CLI client → Stream parser: parses stream (evidence: `src/api/geminicli_client.js`)
- Token manager → Token store: persists tokens (evidence: `src/auth/token_manager.js`)
- Token manager → Quota manager: checks quota (evidence: `src/auth/token_manager.js`)
- Administrator → Admin routes: manages service (evidence: `README.md`)
- Admin routes → Token manager: manages tokens (evidence: `src/routes/admin.js`)
- Admin routes → CLI token manager: manages CLI tokens (evidence: `src/routes/admin.js`)
- Admin routes → Quota manager: reads quotas (evidence: `src/routes/admin.js`)
- Admin routes → OAuth manager: starts OAuth (evidence: `src/routes/admin.js`)
- Admin routes → Configuration: updates settings (evidence: `src/routes/admin.js`)
- Configuration → HTTP server: configures (evidence: `src/server/index.js`)
- HTTP server → Memory manager: starts cleanup (evidence: `src/server/index.js`)
- HTTP server → Logger: logs events (evidence: `src/server/index.js`)
- Logger → Log WebSocket: stores logs (evidence: `src/utils/logger.js`)
- API client → Memory manager: uses memory controls (evidence: `src/api/client.js`)
