MiroFish 2026 : guide d'installation sur Mac M4 distant

MiroFish (AGPL-3.0) transforme des documents seed en un monde GraphRAG et exécute des simulations multi-agents via OASIS. Interface Vue sur le port 3000, API sur le port 5001. Sur un nœud M4 KuzCloud, privilégiez Docker Compose, budgétez 16 Go (centaines d'agents) ou 24 Go (1K+ personas légers).

Avant de commencer, ouvrez la page tarifs et le centre d'aide pour SSH et pare-feu. Latence API asiatique : Japon ou Hong Kong ; clés OpenAI : côte Est US.

Qu'est-ce que MiroFish ?

Cinq étapes : construction de graphe → environnement → simulation (OASIS) → rapport (ReportAgent) → interaction profonde. Voir TradingAgents pour la couche d'exécution trading — MiroFish modélise des essaims sociaux.

Matériel et RAM

Charge	Agents	SKU	Notes
Démo	50–200	M4 16 Go	Docker + UI
Équipe	500–2 000	M4 24 Go	Workers OASIS parallèles
Stress	5 000+	24 Go + budget API	Hôtes distribués au-delà

Matrice 16/24 Go · Rafale vs mensuel

Installation KuzCloud en 5 étapes

Étape 1 — Nœud et SSH

Commander un M4, ssh -i key.pem user@node-ip, brew install colima docker && colima start. Identifiants en ~5 min — même flux que OpenClaw distant.

Étape 2 — Clone et .env

git clone https://github.com/666ghj/MiroFish.git · cp .env.example .env

Étape 3 — Docker Compose

docker compose up -d — tunnel ssh -L 3000:localhost:3000 -L 5001:localhost:5001 ...

Étape 4 — Prédiction

Seed → objectif en langage naturel → rapport. Premier run 16 Go : 30–90 min.

Étape 5 — Artefacts

~/mirofish-runs/, puis docker compose down et libération du nœud si rafale journalière.

Réseau, API, conformité

• Coûts LLM dominants — 50–200 $ par expérience possible à 1 000 agents
• AGPL-3.0 si SaaS réseau
• Résidence des seeds sur le disque loué — matrice régions

Dépannage

Symptôme	Cause	Correctif
Sim à 0 %	Clé .env	Quota et modèle
OOM compose	16 Go saturés	24 Go ou moins d'agents
Port 3000 refusé	Compose / tunnel	docker ps, -L SSH

FAQ

Sans Docker ? Possible, Docker recommandé.

GPU ? Non requis.

OpenClaw ? Agent code vs simulation sociale.

Durée min ? 3–7 jours rafale.

TradingAgents même M4 ? 24 Go, pas deux sims lourdes.