# 1nteractme/antigravity-gateway architecture

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

- Interactive diagram: https://gitdiagram.com/1nteractme/antigravity-gateway
- Repository: https://github.com/1nteractme/antigravity-gateway

## Overview

Antigravity AI Gateway is an OpenAI-compatible Cloudflare Worker. A client request enters the Worker, which handles public endpoints directly and applies API-key authentication and per-key rate limits to `/v1` requests. Chat completions are validated, routed to a configured model/provider, and returned as normalized JSON or an SSE stream; retryable provider failures may follow configured fallback chains. The graph reflects documented capabilities and indexed imports; rate-limiter internals and Anthropic implementation details were not excerpted.

Main entry points: [`src/index.ts`](https://github.com/1nteractme/antigravity-gateway/blob/main/src/index.ts) (Worker endpoints), [`src/router/modelRouter.ts`](https://github.com/1nteractme/antigravity-gateway/blob/main/src/router/modelRouter.ts) (Model router), [`src/providers/createProviderRegistry.ts`](https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/createProviderRegistry.ts) (Provider factory), [`src/api/chatCompletions.ts`](https://github.com/1nteractme/antigravity-gateway/blob/main/src/api/chatCompletions.ts) (Chat handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Worker entry"]
  node_worker["Worker endpoints<br/>[index.ts]"]
  node_auth["API-key auth<br/>[apiKey.ts]"]
  node_rate[("Per-key limiter<br/>[rateLimiter.ts]")]
end

subgraph group_request["Request handling"]
  node_chat["Chat handler<br/>[chatCompletions.ts]"]
  node_validation["Request validation"]
  node_gatewayconfig["Gateway settings<br/>[gatewayConfig.ts]"]
end

subgraph group_routing["Model routing"]
  node_models["Model catalog<br/>[registry.ts]"]
  node_routes["Fallback rules<br/>[routingConfig.ts]"]
  node_router["Model router<br/>[modelRouter.ts]"]
end

subgraph group_providers["Provider integrations"]
  node_providerconfig["Provider settings"]
  node_factory["Provider factory"]
  node_registry["Provider registry"]
  node_gemini["Gemini adapter<br/>[geminiProvider.ts]"]
  node_anthropic["Anthropic adapter"]
end

subgraph group_shared["Shared services"]
  node_timeouts["Timed fetch"]
  node_errors["Gateway errors<br/>[errors.ts]"]
  node_responses["JSON responses<br/>[response.ts]"]
end

node_client(("API client"))
node_geminiapi["Gemini API"]
node_anthropicapi["Anthropic API"]

node_client -->|"sends requests"| node_worker
node_worker -->|"authenticates"| node_auth
node_worker -->|"checks limits"| node_rate
node_worker -->|"dispatches chat"| node_chat
node_worker -->|"loads settings"| node_gatewayconfig
node_worker -->|"lists models"| node_models
node_worker -->|"formats responses"| node_responses
node_chat -->|"validates input"| node_validation
node_chat -->|"uses limits"| node_gatewayconfig
node_chat -->|"routes completion"| node_router
node_gatewayconfig -->|"parses model config"| node_models
node_gatewayconfig -->|"parses routing config"| node_routes
node_router -->|"creates providers"| node_factory
node_router -->|"resolves model"| node_models
node_router -->|"selects fallbacks"| node_routes
node_router -->|"looks up provider"| node_registry
node_factory -->|"uses provider settings"| node_providerconfig
node_factory -->|"registers adapters"| node_registry
node_factory -->|"registers Gemini"| node_gemini
node_factory -->|"registers Anthropic"| node_anthropic
node_gemini -->|"calls API"| node_geminiapi
node_anthropic -->|"calls API"| node_anthropicapi
node_gemini -->|"uses timed fetch"| node_timeouts
node_anthropic -->|"uses timed fetch"| node_timeouts
node_gemini -->|"raises provider errors"| node_errors
node_anthropic -->|"raises provider errors"| node_errors

click node_worker "https://github.com/1nteractme/antigravity-gateway/blob/main/src/index.ts"
click node_auth "https://github.com/1nteractme/antigravity-gateway/blob/main/src/auth/apiKey.ts"
click node_rate "https://github.com/1nteractme/antigravity-gateway/blob/main/src/ratelimit/rateLimiter.ts"
click node_chat "https://github.com/1nteractme/antigravity-gateway/blob/main/src/api/chatCompletions.ts"
click node_validation "https://github.com/1nteractme/antigravity-gateway/blob/main/src/api/validateChatCompletion.ts"
click node_gatewayconfig "https://github.com/1nteractme/antigravity-gateway/blob/main/src/config/gatewayConfig.ts"
click node_models "https://github.com/1nteractme/antigravity-gateway/blob/main/src/models/registry.ts"
click node_routes "https://github.com/1nteractme/antigravity-gateway/blob/main/src/router/routingConfig.ts"
click node_router "https://github.com/1nteractme/antigravity-gateway/blob/main/src/router/modelRouter.ts"
click node_providerconfig "https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/createProviderConfig.ts"
click node_factory "https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/createProviderRegistry.ts"
click node_registry "https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/providerRegistry.ts"
click node_gemini "https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/geminiProvider.ts"
click node_anthropic "https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/anthropicProvider.ts"
click node_timeouts "https://github.com/1nteractme/antigravity-gateway/blob/main/src/utils/fetchWithTimeout.ts"
click node_errors "https://github.com/1nteractme/antigravity-gateway/blob/main/src/utils/errors.ts"
click node_responses "https://github.com/1nteractme/antigravity-gateway/blob/main/src/utils/response.ts"

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_worker,node_auth,node_rate,node_client toneBlue
class node_chat,node_validation,node_gatewayconfig toneAmber
class node_models,node_routes,node_router,node_geminiapi,node_anthropicapi toneMint
class node_providerconfig,node_factory,node_registry,node_gemini,node_anthropic toneRose
class node_timeouts,node_errors,node_responses toneIndigo
```

## Components

### Worker entry

- [Worker endpoints](https://github.com/1nteractme/antigravity-gateway/blob/main/src/index.ts): `src/index.ts`
- [API-key auth](https://github.com/1nteractme/antigravity-gateway/blob/main/src/auth/apiKey.ts): `src/auth/apiKey.ts`
- [Per-key limiter](https://github.com/1nteractme/antigravity-gateway/blob/main/src/ratelimit/rateLimiter.ts): `src/ratelimit/rateLimiter.ts`

### Request handling

- [Chat handler](https://github.com/1nteractme/antigravity-gateway/blob/main/src/api/chatCompletions.ts): `src/api/chatCompletions.ts`
- [Request validation](https://github.com/1nteractme/antigravity-gateway/blob/main/src/api/validateChatCompletion.ts): `src/api/validateChatCompletion.ts`
- [Gateway settings](https://github.com/1nteractme/antigravity-gateway/blob/main/src/config/gatewayConfig.ts): `src/config/gatewayConfig.ts`

### Model routing

- [Model catalog](https://github.com/1nteractme/antigravity-gateway/blob/main/src/models/registry.ts): `src/models/registry.ts`
- [Fallback rules](https://github.com/1nteractme/antigravity-gateway/blob/main/src/router/routingConfig.ts): `src/router/routingConfig.ts`
- [Model router](https://github.com/1nteractme/antigravity-gateway/blob/main/src/router/modelRouter.ts): `src/router/modelRouter.ts`

### Provider integrations

- [Provider settings](https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/createProviderConfig.ts): `src/providers/createProviderConfig.ts`
- [Provider factory](https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/createProviderRegistry.ts): `src/providers/createProviderRegistry.ts`
- [Provider registry](https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/providerRegistry.ts): `src/providers/providerRegistry.ts`
- [Gemini adapter](https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/geminiProvider.ts): `src/providers/geminiProvider.ts`
- [Anthropic adapter](https://github.com/1nteractme/antigravity-gateway/blob/main/src/providers/anthropicProvider.ts): `src/providers/anthropicProvider.ts`

### Shared services

- [Timed fetch](https://github.com/1nteractme/antigravity-gateway/blob/main/src/utils/fetchWithTimeout.ts): `src/utils/fetchWithTimeout.ts`
- [Gateway errors](https://github.com/1nteractme/antigravity-gateway/blob/main/src/utils/errors.ts): `src/utils/errors.ts`
- [JSON responses](https://github.com/1nteractme/antigravity-gateway/blob/main/src/utils/response.ts): `src/utils/response.ts`

### Other components

- **API client**
- **Gemini API**
- **Anthropic API**

## Connections

- API client → Worker endpoints: sends requests (evidence: `README.md`)
- Worker endpoints → API-key auth: authenticates (evidence: `src/index.ts`)
- Worker endpoints → Per-key limiter: checks limits (evidence: `src/index.ts`)
- Worker endpoints → Chat handler: dispatches chat (evidence: `src/index.ts`)
- Worker endpoints → Gateway settings: loads settings (evidence: `src/index.ts`)
- Worker endpoints → Model catalog: lists models (evidence: `src/index.ts`)
- Worker endpoints → JSON responses: formats responses (evidence: `src/index.ts`)
- Chat handler → Request validation: validates input (evidence: `src/api/chatCompletions.ts`)
- Chat handler → Gateway settings: uses limits (evidence: `src/api/chatCompletions.ts`)
- Chat handler → Model router: routes completion (evidence: `src/api/chatCompletions.ts`)
- Gateway settings → Model catalog: parses model config (evidence: `src/config/gatewayConfig.ts`)
- Gateway settings → Fallback rules: parses routing config (evidence: `src/config/gatewayConfig.ts`)
- Model router → Provider factory: creates providers (evidence: `src/router/modelRouter.ts`)
- Model router → Model catalog: resolves model (evidence: `src/router/modelRouter.ts`)
- Model router → Fallback rules: selects fallbacks (evidence: `src/router/modelRouter.ts`)
- Model router → Provider registry: looks up provider (evidence: `src/router/modelRouter.ts`)
- Provider factory → Provider settings: uses provider settings (evidence: `src/providers/createProviderRegistry.ts`)
- Provider factory → Provider registry: registers adapters (evidence: `src/providers/createProviderRegistry.ts`)
- Provider factory → Gemini adapter: registers Gemini (evidence: `src/providers/createProviderRegistry.ts`)
- Provider factory → Anthropic adapter: registers Anthropic (evidence: `src/providers/createProviderRegistry.ts`)
- Gemini adapter → Gemini API: calls API (evidence: `README.md`)
- Anthropic adapter → Anthropic API: calls API (evidence: `README.md`)
- Gemini adapter → Timed fetch: uses timed fetch (evidence: `src/providers/geminiProvider.ts`)
- Anthropic adapter → Timed fetch: uses timed fetch (evidence: `src/providers/anthropicProvider.ts`)
- Gemini adapter → Gateway errors: raises provider errors (evidence: `src/providers/geminiProvider.ts`)
- Anthropic adapter → Gateway errors: raises provider errors (evidence: `src/providers/anthropicProvider.ts`)
