How chaoticmindv/master-v-bates works
Arena Desktop embeds arena.ai in a Windows desktop window and serves a local Flask interface. The principal workflow is user message → local UI/API → embedded arena.ai session → streamed reply; when a folder is selected, the app also mediates model tool calls under permission settings. The README documents modes, modalities, accounts, chat history, and Code-mode file copying. Several subsystem links below are documented rather than verified from complete source; unsampled implementation details are not inferred.
Main entry points: app.py Flask API · __init__.py Tool registry · engine.py Embedded engine · desktop.py Desktop window
Components 20
Desktop experience
- Desktop window
arena/desktop.py - Local web UI
arena/web/static/app.js - Flask API
arena/web/app.py
Conversation runtime
- Embedded engine
arena/engine.py - Wire contracts
arena/contracts.py - Arena API client
arena/api.py - Model catalog
arena/models.py - OpenAI compatibility
arena/web/openai_compat.py
Accounts and state
- Account management
arena/accounts.py - Authentication
arena/auth.py - Settings and storage
arena/config.py
Workspace tools
- Tool-call agent
arena/agent.py - Permission modes
arena/permissions.py - File operations
arena/tools/file_tools.py - Tool registry
arena/tools/__init__.py - Shell commands
arena/tools/shell_tools.py - Browser tools
arena/tools/browser_mcp.py - Code workspace
arena/workspace.py
Other components
- User
- Arena.ai
Connections 23
- User → Desktop window: uses
README.md - Desktop window → Flask API: starts
arena/desktop.py - Desktop window → Embedded engine: hosts
arena/desktop.py - User → Local web UI: sends messages
README.md - Local web UI → Flask API: requests
README.md - Flask API → Embedded engine: dispatches chats
arena/web/app.py - Embedded engine → Arena.ai: sends and streams
README.md - Flask API → Arena API client: uses client
arena/web/app.py - Flask API → Wire contracts: formats requests
arena/web/app.py - Embedded engine → Wire contracts: uses formats
arena/engine.py - Flask API → Model catalog: loads catalog
arena/web/app.py - Flask API → OpenAI compatibility: serves compatibility
arena/web/app.py - Flask API → Account management: manages accounts
arena/web/app.py - Account management → Authentication: uses authentication
arena/accounts.py - Account management → Settings and storage: persists account data
arena/accounts.py - Flask API → Settings and storage: reads and writes
arena/web/app.py - Flask API → Tool-call agent: runs tool calls
arena/web/app.py - Flask API → Permission modes: enforces modes
README.md - Tool-call agent → Tool registry: dispatches tools
- Tool registry → File operations: registers
arena/tools/__init__.py - Tool registry → Shell commands: registers
arena/tools/__init__.py - Tool registry → Browser tools: registers
arena/tools/__init__.py - Flask API → Code workspace: copies Code outputs
README.md