How aluro7in/mirofish works
MiroFish is a multi-agent prediction engine: users submit seed documents and a natural-language prediction requirement, build a knowledge graph, configure and run a simulated social environment, then inspect reports and interact with the simulated world. The README documents graph construction, entity/persona and environment setup, parallel Twitter/Reddit simulation, report analysis, and interaction. The graph reflects that workflow; unsampled API and service implementations are represented only where their responsibilities are explicit in the README or file tree.
Main entry points: graph.py Graph routes · simulation.py Simulation routes · simulation_manager.py Simulation preparation · Process.vue Graph workflow
Components 26
User experience
- Home and history
frontend/src/views/Home.vue - Graph workflow
frontend/src/views/Process.vue - Simulation workflow
frontend/src/views/SimulationView.vue - Report view
frontend/src/views/ReportView.vue - World interaction
frontend/src/views/InteractionView.vue - Graph API client
frontend/src/api/graph.js - Simulation API client
frontend/src/api/simulation.js - Report API client
frontend/src/api/report.js
Seed and graph
- Graph routes
backend/app/api/graph.py - Project state
backend/app/models/project.py - Seed text extraction
backend/app/utils/file_parser.py - Ontology generation
backend/app/services/ontology_generator.py - Graph construction
backend/app/services/graph_builder.py
Simulation
- Simulation routes
backend/app/api/simulation.py - Simulation preparation
backend/app/services/simulation_manager.py - Entity reading
backend/app/services/zep_entity_reader.py - Agent profiles
backend/app/services/oasis_profile_generator.py - Simulation configuration
backend/app/services/simulation_config_generator.py - Simulation runner
backend/app/services/simulation_runner.py
Reports and interaction
- Report routes
backend/app/api/report.py - Report analysis agent
backend/app/services/report_agent.py - Simulation interaction tools
backend/app/services/zep_tools.py
Other components
- User
- Zep graph memory
- OASIS engine
- LLM service
Connections 32
- User → Home and history: starts
- Home and history → Graph workflow: opens workflow
- User → Graph workflow: submits seeds
- Graph workflow → Graph API client: requests graph work
- Graph API client → Graph routes: calls
- Graph routes → Project state: stores project
- Graph routes → Seed text extraction: extracts seed text
- Graph routes → Ontology generation: generates ontology
- Ontology generation → LLM service: generates with
- Graph routes → Graph construction: builds graph
- Graph construction → Zep graph memory: writes graph
- User → Simulation workflow: sets simulation
- Simulation workflow → Simulation API client: requests simulation
- Simulation API client → Simulation routes: calls
- Simulation routes → Simulation preparation: prepares simulation
- Simulation preparation → Entity reading: reads entities
- Entity reading → Zep graph memory: reads graph
- Simulation preparation → Agent profiles: generates profiles
- Agent profiles → LLM service: generates with
- Simulation preparation → Simulation configuration: generates configuration
- Simulation configuration → LLM service: generates with
- Simulation routes → Simulation runner: starts and monitors
- Simulation runner → OASIS engine: runs simulation
- User → Report view: requests report
- Report view → Report API client: requests analysis
- Report API client → Report routes: calls
- Report routes → Report analysis agent: creates report
- Report analysis agent → LLM service: analyzes with
- User → World interaction: interacts
- World interaction → Simulation API client: sends interaction
- Simulation routes → Simulation interaction tools: dispatches interaction
- Simulation interaction tools → Zep graph memory: accesses graph memory