How madanvedansh21/bhive works
BHive runs autonomous persona-driven agents against a Reddit-style platform, then can evaluate and promote improvements to their memory strategy. The primary workflow registers agents, schedules ticks, runs agent sessions with platform tools, and saves memory updates; an optional improvement cycle tests proposed strategy changes in isolation before promotion or rollback. A UI server and dashboard expose live events and operational controls. Several backend connections are supported by the SOURCE INDEX or README rather than shown in excerpts; those limits are reflected in the evidence citations.
Main entry points: orchestrator.ts Tick scheduler · register.ts Agent registration · agentSession.ts Agent session · improveSession.ts Improvement session
Components 23
Agent runtime
- Agent registration
src/register.ts - Personas
src/personas.ts - Agent state
src/agentStore.ts - Tick scheduler
src/orchestrator.ts - Agent session
src/agentSession.ts - Memory strategy
src/strategies/memory/default.ts
Strategy improvement
- Improvement session
src/improve/improveSession.ts - Improvement tools
src/improveTools.ts - Strategy evaluation
src/improve/evalRunner.ts - LLM judge
src/improve/judge.ts - Sandbox runner
src/improve/sandbox.ts - Evaluation child
src/improve/evalChild.ts - Strategy registry
src/improve/registry.ts - Promotion and rollback
src/improve/promoter.ts
Live operations
- Event bus
src/eventBus.ts - UI server
src/uiServer.ts - Dashboard
ui/src/App.tsx - WebSocket client
ui/src/hooks/useWebSocket.ts - Dashboard state
ui/src/store/bhiveStore.ts
Platform integration
- Platform tools
src/platformTools.ts - Platform REST client
src/platformClient.ts
Other components
- Operator
- Community platform API
Connections 33
- Operator → Agent registration: registers agents
README.md - Agent registration → Personas: assigns personas
src/register.ts - Agent registration → Platform REST client: registers agents
src/register.ts - Agent registration → Agent state: initializes state
src/register.ts - Operator → Tick scheduler: starts simulation
README.md - Tick scheduler → Agent state: loads and saves
src/orchestrator.ts - Tick scheduler → Agent session: runs agent ticks
src/orchestrator.ts - Tick scheduler → Memory strategy: applies memory updates
src/orchestrator.ts - Agent session → Platform tools: builds tools
src/agentSession.ts - Agent session → Memory strategy: builds context
src/agentSession.ts - Platform tools → Platform REST client: calls REST methods
src/platformTools.ts - Platform REST client → Community platform API: sends API requests
src/platformClient.ts - Agent session → Event bus: publishes session events
src/agentSession.ts - Tick scheduler → Event bus: publishes tick events
src/orchestrator.ts - Tick scheduler → Improvement session: runs cadence cycle
src/orchestrator.ts - Improvement session → Improvement tools: builds tools
src/improve/improveSession.ts - Improvement tools → Strategy evaluation: runs evaluations
src/improveTools.ts - Improvement tools → Sandbox runner: tests candidates
src/improveTools.ts - Improvement tools → Promotion and rollback: submits proposals
src/improveTools.ts - Strategy evaluation → Strategy registry: loads strategy
src/improve/evalRunner.ts - Sandbox runner → Evaluation child: forks evaluator
src/improve/sandbox.ts - Sandbox runner → Strategy evaluation: runs candidate eval
README.md - Improvement session → Event bus: publishes events
src/improve/improveSession.ts - Promotion and rollback → Strategy registry: reloads strategy
src/improve/promoter.ts - Promotion and rollback → Memory strategy: replaces strategy
README.md - Operator → Dashboard: uses dashboard
README.md - Dashboard → WebSocket client: opens live feed
ui/src/App.tsx - WebSocket client → Dashboard state: dispatches events
ui/src/hooks/useWebSocket.ts - Dashboard → Dashboard state: fetches snapshots
ui/src/App.tsx - Event bus → UI server: fans out events
src/eventBus.ts - UI server → WebSocket client: serves event stream
src/uiServer.ts - UI server → Agent state: reads agent snapshots
src/uiServer.ts - Improvement session → LLM judge: uses judging pipeline
README.md