mirofish

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

23 articles 4.2k View on GitHub ↗
23 articles
Logging and Error Handling Strategies in the MiroFish Backend: A Layered Observability Approach

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.

best-practices
Feb 23, 2026
How MiroFish Tracks and Associates 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.

how-to-guide
Feb 23, 2026
MiroFish Simulation Platform Limitations: Current Constraints and Architectural Boundaries

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.

architecture
Feb 23, 2026
How the Text Processor Handles Chunking with Overlapping Segments for Graph Building in Mirofish

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

internals
Feb 23, 2026
MiroFish API Endpoints 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.

api-reference
Feb 23, 2026
How Simulation Run States Are Persisted and Retrieved in MiroFish for Resuming and Analysis

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

internals
Feb 23, 2026
MiroFish Progress Callback Mechanism: 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.

internals
Feb 23, 2026
How the Entity Reader Enriches Graph Nodes with Relationship Information in MiroFish

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.

deep-dive
Feb 23, 2026
CSV vs JSON Profile Formats in Mirofish: Twitter and Reddit Agent Differences

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.

deep-dive
Feb 23, 2026
Environment Variables for Deploying MiroFish in Production: Required and Optional Configuration

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.

configuration
Feb 23, 2026
How the Mirofish Graph Builder Processes Large Batches of Text and Tracks 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.

internals
Feb 23, 2026
Retry Mechanisms for LLM API Calls in Mirofish: A Deep Dive into Resilient AI Integration

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.

deep-dive
Feb 23, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →