How extractumio/ag3ntum works
Ag3ntum is a self-hosted, sandboxed operations agent: an operator submits a task through the web UI or REST API, the platform manages the session and queue, and the agent executes tools against local mounts or remote infrastructure while streaming progress for review and approval. The architecture also includes administration, reseller management, document processing, model routing, and SSH operations. Relationships below follow README statements and SOURCE INDEX references; several subsystems are only represented by their exact enclosing directory because their implementation was not sampled.
Main entry points: main.py REST API · agent_runner.py Agent runner · agent.py Agent runtime · ag3ntum Agent tools
Components 20
Operator experience
- Web interface
src/web_terminal_client/src/App.tsx - Client API
src/web_terminal_client/src/api.ts - Admin console
src/web_terminal_client/src/pages/admin/AdminRoutes.tsx - Reseller console
src/web_terminal_client/src/pages/reseller/ResellerRoutes.tsx
API and orchestration
- REST API
src/api/main.py - Authentication
src/services/auth_service.py - Session service
src/services/session_service.py - Task queue
src/services/task_queue.py - Queue quotas
src/services/quota_manager.py - Session events
src/services/event_service.py - Platform database
src/db/database.py
Agent execution
- Agent runner
src/services/agent_runner.py - Agent runtime
src/core/agent.py - Agent tools
tools/ag3ntum - Sandbox and security
src/core/sandbox.py - Document processing
tools/ag3ntum/ag3ntum_read_document
Operations and integrations
- SSH operations
src/services/ssh_service_manager.py - LLM proxy
src/api/routes/llm_proxy.py
Other components
- Operator
- Managed infrastructure
Connections 22
- Operator → Web interface: describes task
- Web interface → Client API: submits requests
src/web_terminal_client/src/App.tsx - Client API → REST API: calls REST API
- REST API → Authentication: authenticates
- REST API → Session service: manages sessions
src/api/main.py - Session service → Platform database: reads and writes
src/services/session_service.py - REST API → Task queue: starts queue
src/api/main.py - REST API → Queue quotas: initializes quotas
src/api/main.py - REST API → Agent runner: dispatches tasks
src/api/main.py - Task queue → Agent runner: runs queued tasks
- Agent runner → Agent runtime: runs agent
src/services/agent_runner.py - Agent runtime → Agent tools: invokes tools
- Agent runtime → Sandbox and security: executes isolated
- Agent tools → Managed infrastructure: operates on
- Agent runner → Session events: publishes progress
src/services/agent_runner.py - Session events → Web interface: streams updates
- Operator → Admin console: manages platform
src/web_terminal_client/src/pages/admin/AdminRoutes.tsx - Operator → Reseller console: manages tenants
src/web_terminal_client/src/pages/reseller/ResellerRoutes.tsx - REST API → SSH operations: initializes SSH
src/api/main.py - SSH operations → Managed infrastructure: connects remotely
- REST API → LLM proxy: routes model requests
src/api/routes/llm_proxy.py - Agent tools → Document processing: processes uploads