Mirofish — Development skill for Claude Code


MiroFish

**[Leia em Português](#mirofish-português)**

A swarm intelligence prediction engine. Upload documents describing any scenario, and MiroFish simulates thousands of AI agents reacting on social media to predict how events will unfold.

**Live:** [synth.scty.org](https://synth.scty.org)

Fork of [666ghj/MiroFish](https://github.com/666ghj/MiroFish) — fully translated to English, local KuzuDB graph storage, Claude/Codex CLI support added.

What it does

1. Upload reality seeds — PDFs, markdown, or text files (news articles, policy drafts, financial reports, anything)
2. Describe what to predict — natural language prompt (e.g., "Predict public reaction to this policy over 60 days")
3. MiroFish builds a world — extracts entities and relationships into a knowledge graph, generates AI agent personas with distinct personalities and opinions
4. Agents simulate social media — dual-platform simulation (Twitter + Reddit) where agents post, reply, like, argue, and follow each other
5. Get a prediction report — AI analyzes all simulation data and produces findings. Chat with the report agent or interview individual simulated agents.

Changes from upstream

Area	Upstream	This fork
Language	Chinese UI + prompts	Full English (60+ files translated)
LLM providers	Alibaba Qwen only	OpenAI, Anthropic, Claude CLI, Codex CLI
Graph database	Hosted graph service	Local KuzuDB (embedded, free)
Entity extraction	Managed extraction pipeline	LLM-based extraction (uses your own model)
Auth	Requires API keys	Can use Claude Code or Codex CLI subscriptions (no separate API cost)

Quick start

Prerequisites

• Node.js 18+
• Python 3.11-3.12
• uv (Python package manager)

Setup

cp .env.example .env
# Edit .env — pick your LLM provider (see below)
npm run setup:all