How reworkd/agentgpt works
AgentGPT is a browser-based autonomous-agent product: users configure an agent and goal, then the agent plans tasks, executes tools, and can continue learning from results. The repository separates a Next.js interface and API client from a FastAPI platform that provides agent execution, model selection, tool integrations, authentication, and OAuth-backed credentials. The README documents the product workflow; source excerpts show selected API routing and agent-service internals. Several frontend-to-platform links and unsampled capabilities are shown only as unverified connections.
Main entry points: open_ai_agent_service.py Agent service · router.py API routes · agent_service_provider.py Service provider · index.tsx Agent workspace
Components 22
Browser application
- Agent workspace
next/src/pages/agent/index.tsx - Task sidebar
next/src/components/drawer/TaskSidebar.tsx - Agent client
next/src/services/agent - Agent templates
next/src/pages/templates.tsx
Platform API
- API application
platform/reworkd_platform/web/application.py - API routes
platform/reworkd_platform/web/api/router.py - Agent API
platform/reworkd_platform/web/api/agent - Model endpoints
platform/reworkd_platform/web/api/models
Agent execution
- Service provider
platform/reworkd_platform/web/api/agent/agent_service/agent_service_provider.py - Agent service
platform/reworkd_platform/web/api/agent/agent_service/open_ai_agent_service.py - Task analysis
platform/reworkd_platform/web/api/agent/analysis.py - Agent prompts
platform/reworkd_platform/web/api/agent/prompts.py - Agent tools
platform/reworkd_platform/web/api/agent/tools - Token service
platform/reworkd_platform/services/tokenizer/token_service.py - Run settings
platform/reworkd_platform/schemas/agent.py
Identity and credentials
- Auth endpoints
platform/reworkd_platform/web/api/auth - OAuth installs
platform/reworkd_platform/services/oauth_installers.py - OAuth credentials
platform/reworkd_platform/db/crud/oauth.py - Credential records
platform/reworkd_platform/db/models/auth.py
Local setup
- Setup CLI
cli/src/index.js - Environment setup
cli/src/envGenerator.js
Other components
- Agent user
Connections 21
- Agent user → Agent workspace: configures goal
- Agent workspace → Task sidebar: manages tasks
- Agent workspace → Agent client: starts agent
- Agent client → Agent API: requests agent work
- API application → API routes: mounts routes
platform/reworkd_platform/web/application.py - API routes → Agent API: registers routes
platform/reworkd_platform/web/api/router.py - API routes → Auth endpoints: registers routes
platform/reworkd_platform/web/api/router.py - API routes → Model endpoints: registers routes
platform/reworkd_platform/web/api/router.py - Agent API → Service provider: selects service
platform/reworkd_platform/web/api/agent/agent_service/agent_service_provider.py - Service provider → Agent service: provides implementation
platform/reworkd_platform/web/api/agent/agent_service/agent_service_provider.py - Agent service → Task analysis: returns analysis
platform/reworkd_platform/web/api/agent/agent_service/open_ai_agent_service.py - Agent service → Agent prompts: formats prompts
platform/reworkd_platform/web/api/agent/agent_service/open_ai_agent_service.py - Agent service → Agent tools: dispatches tool
platform/reworkd_platform/web/api/agent/agent_service/open_ai_agent_service.py - Agent service → Token service: limits tokens
platform/reworkd_platform/web/api/agent/agent_service/open_ai_agent_service.py - Service provider → Run settings: uses settings
platform/reworkd_platform/web/api/agent/agent_service/agent_service_provider.py - Service provider → OAuth credentials: injects credentials
platform/reworkd_platform/web/api/agent/agent_service/agent_service_provider.py - OAuth installs → OAuth credentials: stores installations
platform/reworkd_platform/services/oauth_installers.py - OAuth credentials → Credential records: queries records
platform/reworkd_platform/db/crud/oauth.py - Agent user → Setup CLI: runs setup
- Setup CLI → Environment setup: generates environment
cli/src/index.js - Agent user → Agent templates: selects templates