How mrleepee/miroclaw works
MiroClaw is a research-armed multi-agent forecasting product. A user supplies seed material, builds a knowledge graph, configures simulated agents, runs phased social simulations, receives calibrated forecasts and a report, then can chat with agents or the report agent. The graph separates the Vue workflow, Flask API, graph construction and storage, simulation execution, and analysis. README documents the product stages; sampled excerpts confirm the phased orchestrator, graph storage, browser research client, simulation preparation, and frontend history access. Some unsampled endpoint-to-service wiring is therefore left implicit.
Main entry points: api API clients · views Workflow views · round_orchestrator.py Round orchestrator · graph_service.py Graph service
Components 32
User workflow
- Workflow views
frontend/src/views - Graph build
frontend/src/components/Step1GraphBuild.vue - Environment setup
frontend/src/components/Step2EnvSetup.vue - Simulation controls
frontend/src/components/Step3Simulation.vue - Report view
frontend/src/components/Step4Report.vue - Deep interaction
frontend/src/components/Step5Interaction.vue - API clients
frontend/src/api
Backend API
- Graph endpoints
backend/app/api/graph.py - Simulation endpoints
backend/app/api/simulation.py - Report endpoints
backend/app/api/report.py - Analytics endpoints
backend/app/api/analytics.py - Project records
backend/app/models/project.py
Knowledge graph
- Graph builder
backend/app/services/graph_builder.py - Ontology generation
backend/app/services/ontology_generator.py - Entity filtering
backend/app/services/graph_entity_reader.py - Graph search
backend/app/services/graph_search_tools.py - Graph service
backend/app/services/local_graph/graph_service.py - Neo4j
backend/app/services/local_graph/neo4j_client.py
Simulation
- Simulation manager
backend/app/services/simulation_manager.py - Round orchestrator
backend/app/agents/round_orchestrator.py - Simulation agents
backend/app/agents - Research tools
backend/app/agents/tools/research.py - Browser research
backend/app/agents/tools/camofox_client.py - OASIS platforms
backend/app/agents/tools/oasis_platform.py - Graph curation
backend/app/agents/curator_agent.py
Forecasting and analysis
- Oracle forecasting
backend/app/agents/oracle_agent.py - Report generation
backend/app/services/report_agent.py - Simulation analysis
backend/app/services/simulation_query_tools.py
Other components
- Researcher
- Camofox browser
- OASIS
- LLM API
Connections 41
- Researcher → Workflow views: uses
- Workflow views → Graph build: starts build
- Workflow views → Environment setup: configures
- Workflow views → Simulation controls: runs
- Workflow views → Report view: reviews
- Workflow views → Deep interaction: continues to chat
- Graph build → API clients: submits graph work
- Environment setup → API clients: submits setup
- Simulation controls → API clients: controls simulation
- Report view → API clients: requests report
- Deep interaction → API clients: sends messages
- API clients → Graph endpoints: calls
- API clients → Simulation endpoints: calls
- API clients → Report endpoints: calls
- API clients → Analytics endpoints: calls
- Graph endpoints → Graph builder: builds graph
- Graph builder → Ontology generation: generates ontology
- Graph builder → Graph service: writes graph
- Simulation endpoints → Simulation manager: prepares and runs
- Simulation manager → Entity filtering: filters graph entities
- Entity filtering → Graph service: reads entities
- Simulation manager → Round orchestrator: runs rounds
- Round orchestrator → Simulation agents: dispatches phases
- Round orchestrator → Research tools: executes research actions
- Research tools → Browser research: searches and extracts
- Browser research → Camofox browser: requests pages
- Round orchestrator → OASIS platforms: coordinates simulation
- OASIS platforms → OASIS: uses platforms
- Round orchestrator → Graph curation: curates findings
- Graph curation → Graph service: updates triples
- Round orchestrator → Oracle forecasting: requests forecasts
- Oracle forecasting → Graph service: reads graph context
- Report endpoints → Report generation: generates report
- Report generation → Oracle forecasting: uses forecasts
- Report generation → Simulation analysis: analyzes behavior
- Simulation analysis → Simulation manager: reads simulation data
- Report endpoints → Project records: reads and writes reports
- Graph service → Neo4j: queries and updates
- Graph search → Graph service: searches graph
- Simulation agents → LLM API: requests responses
- Report generation → LLM API: requests analysis