# rondevs/genos architecture

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

## Overview

Genos is an AI-oriented Rust backend framework built on Axum and Tokio. Its principal workflow is: application startup configures services and builds a router from compile-time registered routes; incoming HTTP requests reach async handlers, where extractors validate input or authenticate callers; handlers can use database and AI services and return HTTP, SSE, or WebSocket responses. The graph also preserves the documented CLI scaffolding and security middleware capabilities. Relationships for unsampled middleware and CLI behavior are included only where the README or source index supports them.

Main entry points: [`genos/src/app.rs`](https://github.com/rondevs/genos/blob/main/genos/src/app.rs) (App lifecycle), [`genos/src`](https://github.com/rondevs/genos/tree/main/genos/src) (Async handlers), [`genos/src/extractors/auth.rs`](https://github.com/rondevs/genos/blob/main/genos/src/extractors/auth.rs) (Auth extractor), [`genos/src/ai/provider.rs`](https://github.com/rondevs/genos/blob/main/genos/src/ai/provider.rs) (AI provider API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_app["App lifecycle<br/>[app.rs]"]
  node_macros["Route macros<br/>[route.rs]"]
  node_router["Route registry<br/>[router.rs]"]
  node_handler["Async handlers"]
end

subgraph group_request["Request and security"]
  node_json["JSON validation<br/>[json.rs]"]
  node_auth_extractor["Auth extractor<br/>[auth.rs]"]
  node_jwt["ES256 JWT<br/>[jwt.rs]"]
  node_api_key["API keys<br/>[api_key.rs]"]
  node_middleware_rate["Rate limiting<br/>[rate_limit.rs]"]
  node_middleware_redis["Redis rate limiting"]
  node_middleware_request["Request IDs<br/>[request_id.rs]"]
  node_middleware_security["Security headers"]
end

subgraph group_services["Data and AI services"]
  node_database[("Database pool<br/>[pool.rs]")]
  node_vector["Vector embeddings<br/>[vector.rs]"]
  node_anthropic["Anthropic client<br/>[anthropic.rs]"]
  node_openai["OpenAI client<br/>[openai.rs]"]
  node_provider["AI provider API<br/>[provider.rs]"]
end

subgraph group_responses["Response types"]
  node_sse["SSE adapter<br/>[sse.rs]"]
  node_websocket["WebSocket response<br/>[ws.rs]"]
  node_errors["HTTP errors<br/>[error.rs]"]
end

subgraph group_developer["Developer tools"]
  node_cli["Project scaffolding<br/>[new.rs]"]
  node_cli_add["Handler and model generator<br/>[add.rs]"]
  node_cli_db["Migration commands<br/>[db.rs]"]
end

node_developer(("HTTP client"))

node_developer -->|"sends requests"| node_app
node_app -->|"builds routes"| node_router
node_macros -->|"registers routes"| node_router
node_router -->|"dispatches to"| node_handler
node_handler -->|"extracts validated input"| node_json
node_handler -->|"extracts identity"| node_auth_extractor
node_auth_extractor -->|"verifies tokens"| node_jwt
node_auth_extractor -->|"checks key hashes"| node_api_key
node_app -->|"configures pool"| node_database
node_app -->|"configures client"| node_anthropic
node_app -->|"configures client"| node_openai
node_handler -.->|"uses database"| node_database
node_handler -.->|"uses embeddings"| node_vector
node_handler -->|"streams completions"| node_provider
node_provider -->|"implemented by"| node_anthropic
node_provider -->|"implemented by"| node_openai
node_handler -->|"adapts stream"| node_sse
node_handler -->|"returns upgrade"| node_websocket
node_handler -->|"returns errors"| node_errors
node_app -->|"applies middleware"| node_middleware_rate
node_app -->|"configures integration"| node_middleware_redis
node_app -->|"applies middleware"| node_middleware_request
node_app -->|"applies middleware"| node_middleware_security
node_cli -->|"offers add commands"| node_cli_add
node_cli -->|"offers database commands"| node_cli_db

click node_app "https://github.com/rondevs/genos/blob/main/genos/src/app.rs"
click node_macros "https://github.com/rondevs/genos/blob/main/genos-macros/src/route.rs"
click node_router "https://github.com/rondevs/genos/blob/main/genos/src/router.rs"
click node_handler "https://github.com/rondevs/genos/tree/main/genos/src"
click node_json "https://github.com/rondevs/genos/blob/main/genos/src/extractors/json.rs"
click node_auth_extractor "https://github.com/rondevs/genos/blob/main/genos/src/extractors/auth.rs"
click node_jwt "https://github.com/rondevs/genos/blob/main/genos/src/auth/jwt.rs"
click node_api_key "https://github.com/rondevs/genos/blob/main/genos/src/auth/api_key.rs"
click node_middleware_rate "https://github.com/rondevs/genos/blob/main/genos/src/middleware/rate_limit.rs"
click node_middleware_redis "https://github.com/rondevs/genos/blob/main/genos/src/middleware/redis_rate_limit.rs"
click node_middleware_request "https://github.com/rondevs/genos/blob/main/genos/src/middleware/request_id.rs"
click node_middleware_security "https://github.com/rondevs/genos/blob/main/genos/src/middleware/security_headers.rs"
click node_database "https://github.com/rondevs/genos/blob/main/genos/src/db/pool.rs"
click node_vector "https://github.com/rondevs/genos/blob/main/genos/src/db/vector.rs"
click node_anthropic "https://github.com/rondevs/genos/blob/main/genos/src/ai/anthropic.rs"
click node_openai "https://github.com/rondevs/genos/blob/main/genos/src/ai/openai.rs"
click node_provider "https://github.com/rondevs/genos/blob/main/genos/src/ai/provider.rs"
click node_sse "https://github.com/rondevs/genos/blob/main/genos/src/ai/sse.rs"
click node_websocket "https://github.com/rondevs/genos/blob/main/genos/src/response/ws.rs"
click node_errors "https://github.com/rondevs/genos/blob/main/genos/src/response/error.rs"
click node_cli "https://github.com/rondevs/genos/blob/main/genos-cli/src/commands/new.rs"
click node_cli_add "https://github.com/rondevs/genos/blob/main/genos-cli/src/commands/add.rs"
click node_cli_db "https://github.com/rondevs/genos/blob/main/genos-cli/src/commands/db.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_app,node_macros,node_router,node_handler,node_developer toneBlue
class node_json,node_auth_extractor,node_jwt,node_api_key,node_middleware_rate,node_middleware_redis,node_middleware_request,node_middleware_security toneAmber
class node_database,node_vector,node_anthropic,node_openai,node_provider toneMint
class node_sse,node_websocket,node_errors toneRose
class node_cli,node_cli_add,node_cli_db toneIndigo
```

## Components

### Application runtime

- [App lifecycle](https://github.com/rondevs/genos/blob/main/genos/src/app.rs): `genos/src/app.rs`
- [Route macros](https://github.com/rondevs/genos/blob/main/genos-macros/src/route.rs): `genos-macros/src/route.rs`
- [Route registry](https://github.com/rondevs/genos/blob/main/genos/src/router.rs): `genos/src/router.rs`
- [Async handlers](https://github.com/rondevs/genos/tree/main/genos/src): `genos/src`

### Request and security

- [JSON validation](https://github.com/rondevs/genos/blob/main/genos/src/extractors/json.rs): `genos/src/extractors/json.rs`
- [Auth extractor](https://github.com/rondevs/genos/blob/main/genos/src/extractors/auth.rs): `genos/src/extractors/auth.rs`
- [ES256 JWT](https://github.com/rondevs/genos/blob/main/genos/src/auth/jwt.rs): `genos/src/auth/jwt.rs`
- [API keys](https://github.com/rondevs/genos/blob/main/genos/src/auth/api_key.rs): `genos/src/auth/api_key.rs`
- [Rate limiting](https://github.com/rondevs/genos/blob/main/genos/src/middleware/rate_limit.rs): `genos/src/middleware/rate_limit.rs`
- [Redis rate limiting](https://github.com/rondevs/genos/blob/main/genos/src/middleware/redis_rate_limit.rs): `genos/src/middleware/redis_rate_limit.rs`
- [Request IDs](https://github.com/rondevs/genos/blob/main/genos/src/middleware/request_id.rs): `genos/src/middleware/request_id.rs`
- [Security headers](https://github.com/rondevs/genos/blob/main/genos/src/middleware/security_headers.rs): `genos/src/middleware/security_headers.rs`

### Data and AI services

- [Database pool](https://github.com/rondevs/genos/blob/main/genos/src/db/pool.rs): `genos/src/db/pool.rs`
- [Vector embeddings](https://github.com/rondevs/genos/blob/main/genos/src/db/vector.rs): `genos/src/db/vector.rs`
- [Anthropic client](https://github.com/rondevs/genos/blob/main/genos/src/ai/anthropic.rs): `genos/src/ai/anthropic.rs`
- [OpenAI client](https://github.com/rondevs/genos/blob/main/genos/src/ai/openai.rs): `genos/src/ai/openai.rs`
- [AI provider API](https://github.com/rondevs/genos/blob/main/genos/src/ai/provider.rs): `genos/src/ai/provider.rs`

### Response types

- [SSE adapter](https://github.com/rondevs/genos/blob/main/genos/src/ai/sse.rs): `genos/src/ai/sse.rs`
- [WebSocket response](https://github.com/rondevs/genos/blob/main/genos/src/response/ws.rs): `genos/src/response/ws.rs`
- [HTTP errors](https://github.com/rondevs/genos/blob/main/genos/src/response/error.rs): `genos/src/response/error.rs`

### Developer tools

- [Project scaffolding](https://github.com/rondevs/genos/blob/main/genos-cli/src/commands/new.rs): `genos-cli/src/commands/new.rs`
- [Handler and model generator](https://github.com/rondevs/genos/blob/main/genos-cli/src/commands/add.rs): `genos-cli/src/commands/add.rs`
- [Migration commands](https://github.com/rondevs/genos/blob/main/genos-cli/src/commands/db.rs): `genos-cli/src/commands/db.rs`

### Other components

- **HTTP client**

## Connections

- HTTP client → App lifecycle: sends requests (evidence: `README.md`)
- App lifecycle → Route registry: builds routes (evidence: `genos/src/router.rs`)
- Route macros → Route registry: registers routes (evidence: `README.md`)
- Route registry → Async handlers: dispatches to (evidence: `genos/src/router.rs`)
- Async handlers → JSON validation: extracts validated input (evidence: `README.md`)
- Async handlers → Auth extractor: extracts identity (evidence: `README.md`)
- Auth extractor → ES256 JWT: verifies tokens (evidence: `genos/src/extractors/auth.rs`)
- Auth extractor → API keys: checks key hashes
- App lifecycle → Database pool: configures pool (evidence: `genos/src/app.rs`)
- App lifecycle → Anthropic client: configures client (evidence: `genos/src/app.rs`)
- App lifecycle → OpenAI client: configures client (evidence: `genos/src/app.rs`)
- Async handlers → Database pool: uses database (evidence: `genos/src/app.rs`)
- Async handlers → Vector embeddings: uses embeddings (evidence: `genos/src/lib.rs`)
- Async handlers → AI provider API: streams completions (evidence: `genos/src/ai/provider.rs`)
- AI provider API → Anthropic client: implemented by (evidence: `genos/src/ai/provider.rs`)
- AI provider API → OpenAI client: implemented by (evidence: `genos/src/ai/provider.rs`)
- Async handlers → SSE adapter: adapts stream (evidence: `genos/src/ai/provider.rs`)
- Async handlers → WebSocket response: returns upgrade (evidence: `genos/src/response/ws.rs`)
- Async handlers → HTTP errors: returns errors (evidence: `genos/src/response/error.rs`)
- App lifecycle → Rate limiting: applies middleware (evidence: `README.md`)
- App lifecycle → Redis rate limiting: configures integration (evidence: `genos/src/app.rs`)
- App lifecycle → Request IDs: applies middleware (evidence: `README.md`)
- App lifecycle → Security headers: applies middleware (evidence: `README.md`)
- Project scaffolding → Handler and model generator: offers add commands (evidence: `genos-cli/src/commands/mod.rs`)
- Project scaffolding → Migration commands: offers database commands (evidence: `genos-cli/src/commands/mod.rs`)
