How vreddy0082/openbot works
OpenBot is a self-hostable workspace for AI coworkers. A person uses a web, desktop, mobile, or chat client to work with agents; agents can be built-in or connected through AG-UI, while models, tools, computers, approvals, and audit are governed within the workspace. The README documents these product capabilities and the high-level architecture. Source excerpts give stronger detail for desktop engine setup and shared model-provider configuration; unsampled subsystems are represented at their exact tree paths, with undocumented internal call links omitted.
Main entry points: main.py Built-in Bots · app/src Web workspace · desktop/src Desktop client · install.rs Engine selection
Components 20
Workspace and governance
- Permissions and approvals
app/src/components/approvals - Audit and review
app/src/components/audit
Agent execution
- Built-in Bots
agent-langgraph-agui/src/main.py - Agent adapters
agent-claude-sdk/src/adapter.py - Agent orchestration
shared/orchestration.ts
Models and tools
- Model providers
shared/model_providers.py - MCP tools
app/src/lib/plugins - Computer control
app/src/lib/computers
Client surfaces
- Web workspace
app/src - Desktop client
desktop/src - Mobile client
mobile/app - Browser extension
extension/src - Chat surfaces
agent-langgraph-agui/src
Local runtime setup
- Engine selection
desktop/src-tauri/src/install.rs - Engine installation
desktop/src-tauri/src/acquire.rs - Engine readiness
desktop/src-tauri/src/engine.rs - Engine versions
desktop/src-tauri/src/engine_versions.rs - Setup experience
desktop/src/App.tsx - Setup failures
desktop/src-tauri/src/problem.rs
Other components
- Workspace user
Connections 24
- Workspace user → Web workspace: uses
README.md - Workspace user → Desktop client: uses
README.md - Workspace user → Mobile client: uses
README.md - Workspace user → Browser extension: uses
README.md - Workspace user → Chat surfaces: uses
README.md - Web workspace → Permissions and approvals: configures
README.md - Web workspace → Audit and review: reviews
README.md - Web workspace → Built-in Bots: connects to
README.md - Desktop client → Built-in Bots: connects to
README.md - Mobile client → Built-in Bots: connects to
README.md - Chat surfaces → Built-in Bots: connects to
README.md - Web workspace → Agent adapters: connects via AG-UI
README.md - Desktop client → Agent adapters: connects via AG-UI
README.md - Built-in Bots → Agent orchestration: uses
- Built-in Bots → Model providers: uses
README.md - Built-in Bots → MCP tools: uses
README.md - Built-in Bots → Computer control: uses
README.md - Agent adapters → Model providers: uses
- Desktop client → Setup experience: runs setup
desktop/src/App.tsx - Setup experience → Engine selection: starts engine setup
desktop/src/App.tsx - Engine selection → Engine installation: installs engine
desktop/src-tauri/src/install.rs - Engine selection → Engine readiness: checks engine
desktop/src-tauri/src/install.rs - Engine selection → Engine versions: checks versions
desktop/src-tauri/src/install.rs - Setup experience → Setup failures: shows failures