How cloudgeni-ai/opengeni works
Opengeni is a self-hostable agent service, not an agent model: users start durable sessions through a product surface or API, the service governs access and orchestration, then runs work on managed sandboxes or connected machines while preserving history, approvals, and outputs. The graph emphasizes documented product stages and sampled runtime components. README-level capabilities such as Knowledge and human approvals are retained; unsampled implementation links are dashed where their wiring is not evidenced in the excerpts.
Main entry points: app.ts API routes · routing-session.ts Sandbox routing · engine.rs Agent runner · client.ts SDK client
Components 21
Product surfaces
- Web console
apps/web/src/App.tsx - SDK client
packages/sdk/src/client.ts - Embedded UI
packages/react/src/client.ts
API and governance
- API routes
apps/api/src/app.ts - MCP tools
apps/api/src/mcp/server.ts - Identity and access
apps/api/src/auth/managed-auth-session-adapter.ts - Integrations
apps/api/src/integrations/oauth-client.ts
Durable sessions
- Session state
packages/db/src/database.ts - Agent orchestration
agent/crates/opengeni-agent/src/job.rs - Agent runner
agent/crates/opengeni-agent/src/engine.rs - Background workers
apps/worker/src/editable-artifact-materializer-storage.ts - Human approvals
apps/api/src/mcp/server.ts
Compute and tools
- Sandbox routing
packages/runtime/src/sandbox/routing/routing-session.ts - Connected machine
agent/crates/opengeni-agent/src/browser_bridge.rs - Browser control
packages/browserd/src/server.ts - Live relay
agent/crates/opengeni-relay/src/server.rs
Knowledge and outputs
- Agent Knowledge
apps/api/src/routes/knowledge.ts - Artifacts
packages/core/src/domain/editable-artifacts/service.ts - Object storage
packages/storage/src/object-storage-bounded.ts
Other components
- User
- Model providers
Connections 22
- User → Web console: starts work
README.md - User → SDK client: starts work
README.md - Web console → API routes: submits session
- Embedded UI → SDK client: uses client
packages/react/src/client.ts - SDK client → API routes: calls API
- API routes → Identity and access: checks identity
apps/api/src/app.ts - API routes → MCP tools: routes tools
- MCP tools → Session state: reads and updates
apps/api/src/mcp/server.ts - API routes → Integrations: handles OAuth
- API routes → Session state: persists events
README.md - Session state → Agent orchestration: drives turns
- Agent orchestration → Agent runner: starts jobs
agent/crates/opengeni-agent/src/engine.rs - Agent runner → Sandbox routing: executes work
- Sandbox routing → Connected machine: dispatches work
- Sandbox routing → Model providers: invokes models
README.md - Sandbox routing → Browser control: controls browser
- Agent runner → Live relay: streams events
- API routes → Human approvals: gates risky actions
README.md - API routes → Agent Knowledge: serves retrieval
README.md - API routes → Artifacts: manages artifacts
- Background workers → Object storage: reads objects
apps/worker/src/editable-artifact-materializer-storage.ts - Artifacts → Object storage: stores content