How asliadarsh/buttlr works
Buttlr is an AI workforce platform: users describe and configure scoped, scheduled AI employees, then supervise their tool use through permissions, approvals, execution history, and audit. The main path runs from the React workspace through the API and domain services into the runtime; scheduled runs enter through the scheduler and worker. The README documents model choice, integrations, analytics, and activity alongside that path. Source excerpts are partial, so unsampled subsystem links are shown only where README documentation or indexed references support them.
Main entry points: router.py REST API routers · executor.py Execution loop · queries.ts API client and queries · repository.py Store and repository
Components 26
Workspace UI
- React workspace
frontend/src/App.tsx - API client and queries
frontend/src/lib/queries.ts - Describe and configure
frontend/src/pages/ButtlrNewPage.tsx - Approvals and activity
frontend/src/components/buttlr/ApprovalCard.tsx
API and domains
- REST API routers
backend/app/api/v1/router.py - Identity and membership
backend/app/auth/service.py - Buttlr management
backend/app/services/buttlrs.py - Approval service
backend/app/services/approvals.py - Audit and analytics
backend/app/services/audit.py
Buttlr runtime
- Natural-language drafting
backend/app/runtime/drafting.py - Execution loop
backend/app/runtime/executor.py - Planner and observations
backend/app/runtime/planner - Permission engine
backend/app/runtime/permissions/engine.py - Tool execution
backend/app/runtime/tools
Models and integrations
- Integration connections
backend/app/integrations/service.py - Provider clients
backend/app/integrations - Model routing
backend/app/runtime/models/router.py - Model providers
backend/app/runtime/models/providers - GitHub, Google, Jira tools
backend/app/runtime/tools/integrations
Persistence and operations
- Schedule dispatch
backend/app/scheduler/service.py - Execution worker
backend/app/workers/runner.py - Store and repository
backend/app/database/repository.py - Firestore or memory
backend/app/database - Execution and approval records
backend/app/schemas/execution.py
Other components
- Workspace user
- Connected work services
Connections 30
- Workspace user → React workspace: configures and supervises
README.md - React workspace → API client and queries: uses API queries
frontend/src/lib/queries.ts - Describe and configure → API client and queries: submits configuration
frontend/src/pages/ButtlrNewPage.tsx - API client and queries → REST API routers: REST and SSE
README.md - REST API routers → Identity and membership: resolves identity
- REST API routers → Buttlr management: routes management
- REST API routers → Approval service: routes decisions
- REST API routers → Audit and analytics: routes activity and analytics
- REST API routers → Integration connections: routes connections
- REST API routers → Natural-language drafting: requests draft configuration
- Buttlr management → Store and repository: persists Buttlrs
- Integration connections → Store and repository: stores credentials
backend/app/integrations/service.py - Store and repository → Firestore or memory: reads and writes
backend/app/database/repository.py - Buttlr management → Schedule dispatch: configures schedules
- Schedule dispatch → Execution worker: dispatches runs
backend/app/scheduler/service.py - Execution worker → Execution loop: runs execution
backend/app/workers/runner.py - Execution loop → Planner and observations: plans and observes
README.md - Planner and observations → Model routing: requests model output
backend/app/runtime/planner/llm.py - Model routing → Model providers: selects provider
- Execution loop → Permission engine: checks each tool call
README.md - Execution loop → Tool execution: executes permitted calls
README.md - Tool execution → Integration connections: resolves credentials
- Tool execution → GitHub, Google, Jira tools: dispatches tools
- GitHub, Google, Jira tools → Provider clients: calls provider clients
- Provider clients → Connected work services: accesses services
README.md - Approval service → Approvals and activity: presents decisions
- Approvals and activity → API client and queries: submits approval
- Execution loop → Execution and approval records: records run state
- Audit and analytics → Execution and approval records: reads execution history
- Execution and approval records → Store and repository: persists domain records