Architecture

Odel is built as a distributed system of Cloudflare Workers, providing global edge deployment with low latency.

Components

Apex API

The main API for authentication, marketplace, and user management.

• Better Auth for authentication
• D1 database for users, modules, and marketplace data
• R2 storage for module assets

Chat API

Orchestrates AI conversations and module execution.

• OpenAI-compatible API
• V8 isolate execution for modules
• Streaming responses

MCP Proxy

Gateway for MCP protocol connections.

• Routes requests to installed modules
• Manages user configurations
• Handles secret encryption

Dev Portal

Developer tools for building and deploying modules.

• Real-time code editor with WebSocket sync
• Container-based builds
• Durable Objects for state management

Module Execution

User Request → Chat API → V8 Isolate → MCP Proxy → Module Worker

1. User sends a message to Chat API
2. AI determines which tools to call
3. Tool calls are executed in V8 isolates
4. MCP Proxy routes to the appropriate module
5. Results are streamed back to the user