# mirofish | BaiFu | Knowledge Base | Instagit

A Simple and Universal Swarm Intelligence Engine, Predicting Anything. 简洁通用的群体智能引擎，预测万物

GitHub Stars: 4.2k

Repository: https://github.com/666ghj/mirofish

---

## Articles

### [Logging and Error Handling Strategies in the MiroFish Backend: A Layered Observability Approach](/666ghj/mirofish/what-logging-and-error-handling-strategies-are-implemented-across-the-backend-services)

Discover MiroFish backend logging and error handling strategies using a four-layer observability approach. Learn about unified logging, JSON-L logs, retries, and granular error handling.

- Tags: best-practices
- Published: 2026-02-23

### [How MiroFish Tracks and Associates Simulations with Specific Projects](/666ghj/mirofish/how-does-the-project-manager-track-and-associate-simulations-with-specific-projects)

Discover how MiroFish tracks simulations by associating them with projects using a project ID. Learn how this ensures durable linkage for your simulation data.

- Tags: how-to-guide
- Published: 2026-02-23

### [MiroFish Simulation Platform Limitations: Current Constraints and Architectural Boundaries](/666ghj/mirofish/what-are-the-known-limitations-of-the-current-simulation-platform-support)

Explore MiroFish simulation platform limitations including Twitter/Reddit support, 30 concurrent LLM requests, 10 Zep memory entity types, and manual triggers. Understand current constraints and architectural boundaries.

- Tags: architecture
- Published: 2026-02-23

### [How the Text Processor Handles Chunking with Overlapping Segments for Graph Building in Mirofish](/666ghj/mirofish/how-does-the-text-processor-handle-chunking-with-overlapping-segments-for-graph-building)

Learn how Mirofish's TextProcessor uses overlapping segments and a sliding window to chunk documents while preserving context for graph building.

- Tags: internals
- Published: 2026-02-23

### [MiroFish API Endpoints for Monitoring Simulation Profiles in Real-Time](/666ghj/mirofish/what-api-endpoints-are-available-for-monitoring-simulation-profiles-in-real-time)

Access MiroFish API endpoints like /api/simulation/<simulation_id>/profiles/realtime to stream Agent Profile data for live monitoring during background generation tasks.

- Tags: api-reference
- Published: 2026-02-23

### [How Simulation Run States Are Persisted and Retrieved in MiroFish for Resuming and Analysis](/666ghj/mirofish/how-are-simulation-run-states-persisted-and-retrieved-for-resuming-or-analysis)

Discover how MiroFish persists and retrieves simulation run states using JSON files and cached data for effortless resuming and detailed analysis.

- Tags: internals
- Published: 2026-02-23

### [MiroFish Progress Callback Mechanism: Monitoring Multi-Stage Simulation Preparation](/666ghj/mirofish/what-is-the-progress-callback-mechanism-for-monitoring-multi-stage-simulation-preparation)

Understand the MiroFish progress callback mechanism for monitoring multi-stage simulation preparation. Track real-time updates via HTTP API, database, and WebSocket.

- Tags: internals
- Published: 2026-02-23

### [How the Entity Reader Enriches Graph Nodes with Relationship Information in MiroFish](/666ghj/mirofish/how-does-the-entity-reader-enrich-graph-nodes-with-information-about-their-relationships)

Discover how the ZepEntityReader enriches graph nodes. Learn how it retrieves incident edges, categorizes them, and uses UUID lookups to populate related_edges and related_nodes for deeper insights.

- Tags: deep-dive
- Published: 2026-02-23

### [CSV vs JSON Profile Formats in Mirofish: Twitter and Reddit Agent Differences](/666ghj/mirofish/what-are-the-differences-between-csv-and-json-profile-formats-for-twitter-and-reddit-agents)

Explore CSV vs JSON profile formats in Mirofish for Twitter and Reddit agents. Understand key differences in data structure and field requirements for efficient agent management.

- Tags: deep-dive
- Published: 2026-02-23

### [Environment Variables for Deploying MiroFish in Production: Required and Optional Configuration](/666ghj/mirofish/what-environment-variables-are-necessary-for-deploying-mirofish-in-a-production-environment)

Deploy MiroFish in production using essential environment variables like LLM_API_KEY and ZEP_API_KEY. Discover optional but recommended settings for security and performance.

- Tags: configuration
- Published: 2026-02-23

### [How the Mirofish Graph Builder Processes Large Batches of Text and Tracks Simulation Episodes](/666ghj/mirofish/how-does-the-graph-builder-process-large-batches-of-text-and-track-simulation-episodes)

Learn how the Mirofish Graph Builder efficiently processes large text batches by chunking and uploading to Zep, while tracking simulation episodes via a background task manager.

- Tags: internals
- Published: 2026-02-23

### [Retry Mechanisms for LLM API Calls in Mirofish: A Deep Dive into Resilient AI Integration](/666ghj/mirofish/what-retry-mechanisms-are-implemented-for-llm-api-calls-to-ensure-robustness)

Discover Mirofish's robust LLM API retry mechanisms including exponential backoff with jitter, async/sync decorators, and JSON recovery. Ensure resilient AI integration in your backend.

- Tags: deep-dive
- Published: 2026-02-23

### [How the MiroFish Ontology Generator Defines and Manages Entity and Edge Types in the Graph](/666ghj/mirofish/how-does-the-ontology-generator-define-and-manage-entity-and-edge-types-in-the-graph)

Learn how the MiroFish ontology generator defines and manages graph entity and edge types by converting simulation documents into a structured knowledge-graph schema using LLM generated JSON and Zep-compatible Python classes.

- Tags: deep-dive
- Published: 2026-02-23

### [MiroFish File Structure for Storing Simulation Data and Configurations](/666ghj/mirofish/what-is-the-file-structure-for-storing-simulation-data-and-configurations)

Explore the MiroFish file structure for simulation data and configurations. Discover how JSON files, agent profiles, and runtime states are organized in dedicated subdirectories for efficient simulation management.

- Tags: how-to-guide
- Published: 2026-02-23

### [How MiroFish Handles Asynchronous Tasks for Long-Running Simulations](/666ghj/mirofish/how-does-the-system-handle-asynchronous-tasks-for-potentially-long-running-simulations)

Discover how MiroFish uses Python's asyncio framework to manage long-running simulations concurrently with graceful shutdown and responsive control.

- Tags: internals
- Published: 2026-02-23

### [Platform Actions for Agents Simulating on Twitter and Reddit in MiroFish](/666ghj/mirofish/what-are-the-available-platform-actions-for-agents-simulating-on-twitter-and-reddit)

Discover MiroFish platform actions for agents simulating on Twitter and Reddit. Explore the specific actions available for each social media platform within the MiroFish framework.

- Tags: how-to-guide
- Published: 2026-02-23

### [How the Simulation Manager Orchestrates Simulation Lifecycle and State Transitions in Mirofish](/666ghj/mirofish/how-does-the-simulation-manager-orchestrate-the-simulation-lifecycle-and-state-transitions)

Discover how the Mirofish Simulation Manager orchestrates the entire simulation lifecycle. Learn how it manages state transitions, preparation pipelines, and execution.

- Tags: internals
- Published: 2026-02-23

### [Entity Filtering When Querying the Zep Graph Memory: A Complete Technical Guide](/666ghj/mirofish/what-is-the-process-for-entity-filtering-when-querying-the-zep-graph-memory)

Master entity filtering in Zep graph memory. Learn to extract domain-specific nodes for cleaner data pipelines. A complete technical guide for efficient querying.

- Tags: how-to-guide
- Published: 2026-02-23

### [How LLM Configuration Is Managed for Different Providers Like OpenAI in Mirofish](/666ghj/mirofish/how-is-llm-configuration-managed-for-different-providers-like-openai)

Learn how Mirofish simplifies LLM configuration for providers like OpenAI. Centralize settings in environment variables for easy provider switching.

- Tags: how-to-guide
- Published: 2026-02-23

### [What Is the Role of the ReportAgent in Generating Simulation Predictions?](/666ghj/mirofish/what-is-the-role-of-the-reportagent-in-generating-simulation-predictions)

Discover the ReportAgent's crucial role in simulation predictions. Learn how this engine orchestrates data into narrative reports via planning, writing, and finalization.

- Tags: deep-dive
- Published: 2026-02-23

### [How OasisProfileGenerator Creates Agent Profiles from Seed Information](/666ghj/mirofish/how-does-the-oasis-profile-generator-create-agent-profiles-from-seed-information)

Discover how OasisProfileGenerator transforms seed data into OASIS agent profiles using hybrid graph searches LLM or rule based generation and multi layer error recovery for robust JSON.

- Tags: how-to-guide
- Published: 2026-02-23

### [Parallel Twitter and Reddit Simulation Architecture in mirofish: Async Orchestration and IPC Design](/666ghj/mirofish/what-is-the-architecture-for-handling-parallel-simulations-of-twitter-and-reddit)

Explore the mirofish architecture for parallel Twitter and Reddit simulations. Discover async orchestration and IPC design for concurrent simulations.

- Tags: architecture
- Published: 2026-02-23

### [How the MiroFish Graph Builder Service Integrates with Zep for Knowledge Graph Construction](/666ghj/mirofish/how-does-the-graph-builder-service-integrate-with-zep-for-knowledge-graph-construction)

Learn how the MiroFish GraphBuilderService integrates with Zep to automate knowledge graph construction by managing initialization, ontology definition, and text chunking.

- Tags: how-to-guide
- Published: 2026-02-23