How 666ghj/mirofish works
MiroFish is a web-based multi-agent prediction engine. Users upload seed material and describe a prediction; the product builds a knowledge graph, prepares agent personas and simulation settings, runs social simulations, generates a report, and supports follow-up interaction with agents and the report agent. The graph preserves those documented stages and the major report, history, and Zep-backed capabilities. Some implementation files were not sampled, so their internal calls are not inferred; edges use documented workflow statements or visible references.
Main entry points: simulation.py Simulation API · Process.vue Workflow views · graph.py Graph API · graph_builder.py Graph builder
Components 20
Web experience
- Workflow views
frontend/src/views/Process.vue - Project history
frontend/src/components/HistoryDatabase.vue
Project and graph
- Graph API
backend/app/api/graph.py - Graph builder
backend/app/services/graph_builder.py - Project state
backend/app/models/project.py - Seed parsing
backend/app/utils/file_parser.py
Simulation engine
- Simulation API
backend/app/api/simulation.py - Entity reader
backend/app/services/zep_entity_reader.py - Persona generator
backend/app/services/oasis_profile_generator.py - Simulation config
backend/app/services/simulation_config_generator.py - Simulation manager
backend/app/services/simulation_manager.py - Simulation runner
backend/app/services/simulation_runner.py
Reports and memory
- Report API
backend/app/api/report.py - Report agent
backend/app/services/report_agent.py - Graph memory updates
backend/app/services/zep_graph_memory_updater.py - Zep query tools
backend/app/services/zep_tools.py - LLM client
backend/app/utils/llm_client.py
Other components
- User
- Zep Cloud
- OASIS engine
Connections 21
- User → Workflow views: submits materials
README.md - Workflow views → Graph API: requests graph build
frontend/src/views/Process.vue - Graph API → Graph builder: builds graph
- Graph API → Project state: updates project
- Graph builder → Seed parsing: parses seed
- Graph builder → Zep Cloud: constructs GraphRAG
README.md - Workflow views → Simulation API: starts simulation setup
README.md - Simulation API → Entity reader: filters entities
backend/app/api/simulation.py - Simulation API → Simulation manager: manages runs
backend/app/api/simulation.py - Simulation manager → Persona generator: generates profiles
backend/app/services/simulation_manager.py - Simulation manager → Simulation config: generates settings
backend/app/services/simulation_manager.py - Simulation API → Simulation runner: runs simulation
backend/app/api/simulation.py - Simulation runner → OASIS engine: executes agents
README.md - Simulation runner → Graph memory updates: updates graph memory
backend/app/services/simulation_runner.py - User → Report API: requests report
README.md - Report API → Report agent: generates report
backend/app/api/report.py - Report agent → LLM client: calls model
backend/app/services/report_agent.py - Report agent → Zep query tools: uses query tools
backend/app/services/report_agent.py - Zep query tools → Zep Cloud: queries graph
backend/app/services/zep_tools.py - User → Graph memory updates: interacts with agents
README.md - Project history → Simulation API: loads history
frontend/src/components/HistoryDatabase.vue