How rondevs/genos works
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: app.rs App lifecycle · src Async handlers · auth.rs Auth extractor · provider.rs AI provider API
Components 24
Application runtime
- App lifecycle
genos/src/app.rs - Route macros
genos-macros/src/route.rs - Route registry
genos/src/router.rs - Async handlers
genos/src
Request and security
- JSON validation
genos/src/extractors/json.rs - Auth extractor
genos/src/extractors/auth.rs - ES256 JWT
genos/src/auth/jwt.rs - API keys
genos/src/auth/api_key.rs - Rate limiting
genos/src/middleware/rate_limit.rs - Redis rate limiting
genos/src/middleware/redis_rate_limit.rs - Request IDs
genos/src/middleware/request_id.rs - Security headers
genos/src/middleware/security_headers.rs
Data and AI services
- Database pool
genos/src/db/pool.rs - Vector embeddings
genos/src/db/vector.rs - Anthropic client
genos/src/ai/anthropic.rs - OpenAI client
genos/src/ai/openai.rs - AI provider API
genos/src/ai/provider.rs
Response types
- SSE adapter
genos/src/ai/sse.rs - WebSocket response
genos/src/response/ws.rs - HTTP errors
genos/src/response/error.rs
Developer tools
- Project scaffolding
genos-cli/src/commands/new.rs - Handler and model generator
genos-cli/src/commands/add.rs - Migration commands
genos-cli/src/commands/db.rs
Other components
- HTTP client
Connections 25
- HTTP client → App lifecycle: sends requests
README.md - App lifecycle → Route registry: builds routes
genos/src/router.rs - Route macros → Route registry: registers routes
README.md - Route registry → Async handlers: dispatches to
genos/src/router.rs - Async handlers → JSON validation: extracts validated input
README.md - Async handlers → Auth extractor: extracts identity
README.md - Auth extractor → ES256 JWT: verifies tokens
genos/src/extractors/auth.rs - Auth extractor → API keys: checks key hashes
- App lifecycle → Database pool: configures pool
genos/src/app.rs - App lifecycle → Anthropic client: configures client
genos/src/app.rs - App lifecycle → OpenAI client: configures client
genos/src/app.rs - Async handlers → Database pool: uses database
genos/src/app.rs - Async handlers → Vector embeddings: uses embeddings
genos/src/lib.rs - Async handlers → AI provider API: streams completions
genos/src/ai/provider.rs - AI provider API → Anthropic client: implemented by
genos/src/ai/provider.rs - AI provider API → OpenAI client: implemented by
genos/src/ai/provider.rs - Async handlers → SSE adapter: adapts stream
genos/src/ai/provider.rs - Async handlers → WebSocket response: returns upgrade
genos/src/response/ws.rs - Async handlers → HTTP errors: returns errors
genos/src/response/error.rs - App lifecycle → Rate limiting: applies middleware
README.md - App lifecycle → Redis rate limiting: configures integration
genos/src/app.rs - App lifecycle → Request IDs: applies middleware
README.md - App lifecycle → Security headers: applies middleware
README.md - Project scaffolding → Handler and model generator: offers add commands
genos-cli/src/commands/mod.rs - Project scaffolding → Migration commands: offers database commands
genos-cli/src/commands/mod.rs