DEV Community

Cover image for MiroFish: Open Source KI Engine für Vorhersagen
Emre Demir
Emre Demir

Posted on • Originally published at apidog.com

MiroFish: Open Source KI Engine für Vorhersagen

Künstliche Intelligenz entwickelt sich rasant, doch die meisten KI-Tools folgen immer noch einem bekannten Muster: Man gibt einem Modell eine Eingabeaufforderung, und es generiert eine Antwort.

Probiere Apidog noch heute aus

In den letzten Jahren hat jedoch eine neue Kategorie von KI-Systemen Aufmerksamkeit erregt: **Multi-Agenten-Simulationen**, bei denen viele KI-Agenten in einer gemeinsamen digitalen Umgebung miteinander interagieren.

Anstatt dass ein einzelnes Modell versucht, eine Antwort vorherzusagen oder zu generieren, simulieren diese Systeme ganze Gruppen autonomer Agenten, die Informationen austauschen, Meinungen bilden und sich gegenseitig beeinflussen.

Eines der meistdiskutierten Projekte in diesem Bereich ist seit Kurzem **MiroFish**, eine Open-Source-Schwarmintelligenz-Engine, die entwickelt wurde, um reale Szenarien mit Tausenden von KI-Agenten zu simulieren. Das Projekt hat unter Entwicklern und KI-Enthusiasten schnell an Zugkraft gewonnen, da es ein ehrgeiziges Ziel verfolgt: die Schaffung einer digitalen Sandbox, in der komplexe Ereignisse – Finanzmärkte, Verschiebungen der öffentlichen Meinung, politische Reaktionen und sogar fiktive Erzählungen – simuliert werden können, bevor sie in der realen Welt geschehen.

💡Sie entwickeln oder interagieren mit KI-Agenten und MCP-Servern? Apidog bietet einen leistungsstarken, integrierten MCP-Client, der speziell für das Debugging und Testen von MCP-Servern entwickelt wurde. Egal, ob Sie über STDIO für lokale Prozesse oder HTTP für Remote-Server verbinden, Apidog bietet eine intuitive visuelle Oberfläche, um ausführbare Tools, vordefinierte Prompts und Server-Ressourcen mühelos zu testen. Es verarbeitet komplexe OAuth 2.0-Authentifizierungen automatisch und rendert dynamisch umfangreiche Markdown- und Bildantworten – was es zum ultimativen Tool für nahtlose MCP-Integrationstests macht.

Im Gegensatz zu traditionellen KI-Tools, die direkt Antworten generieren, baut MiroFish eine ganze **digitale Gesellschaft von KI-Agenten** auf. Jeder Agent verfügt über eigenes Gedächtnis, Persönlichkeitsmerkmale und eine Entscheidungslogik. Wenn ein neues Ereignis eingeführt wird – wie aktuelle Nachrichten, ein Politikvorschlag oder ein Finanzsignal –, beginnen die Agenten miteinander zu interagieren, auf die Informationen zu reagieren und sich gegenseitig im Verhalten zu beeinflussen.

Im Laufe der Zeit erzeugen ihre Interaktionen Muster, die dem ähneln, wie reale Personengruppen auf Ereignisse reagieren. Diese Muster können mögliche Ergebnisse, sich abzeichnende Narrative oder Stimmungsänderungen aufzeigen, was das System zu einer leistungsstarken Umgebung für Experimente und Prognosen macht.

Quelle: X

Was ist MiroFish?

Im Kern ist MiroFish eine **Schwarmintelligenz-Simulations-Engine**, die auf Multi-Agenten-Künstliche Intelligenz aufbaut.

Statt auf ein einzelnes KI-Modell, generiert die Plattform eine große Population autonomer Agenten in einer simulierten digitalen Umgebung. Jeder Agent repräsentiert einen einzelnen Teilnehmer in einer virtuellen Gesellschaft mit eigenen:

  • Persönlichkeitsmerkmalen
  • Verhaltensregeln
  • Langzeitgedächtnis
  • sozialen Beziehungen
  • Entscheidungsprozessen

Agenten tauschen Informationen aus, bilden Meinungen und reagieren auf Ereignisse. Dieses **emergente Verhalten** erzeugt großflächige Ergebnisse aus vielen individuellen Interaktionen – vergleichbar mit Prozessen realer Gesellschaften.

Die Plattform dient als **digitale Sandbox zur Erkundung von „Was-wäre-wenn“-Szenarien** und unterstützt Entwickler beim Test von komplexen Hypothesen in kontrollierten, skalierbaren Umgebungen.

Die Vision: Ein Spiegel kollektiver Intelligenz

MiroFish verfolgt das Ziel, einen **kollektiven Intelligenz-Spiegel der realen Welt** zu bieten. Statt klassische Vorhersagesysteme, die sich auf historische Daten und Statistik stützen, entsteht eine digitale Umgebung, in der Agenten miteinander interagieren und sich beeinflussen.

Typische Anwendungsbeispiele:

  • Schwankungen an Finanzmärkten durch Anlegerstimmung
  • Verbreitung von Social-Media-Trends
  • Schnelle Veränderungen öffentlicher Meinungen nach politischen Ereignissen

Durch Analyse dieser Interaktionen erhalten Entwickler Einblicke in mögliche Entwicklungen realer Ereignisse.

Von Seed-Daten zu einer digitalen Welt

Um eine Simulation zu starten, benötigt MiroFish **Seed-Material** – also die Ausgangsdaten für das gewünschte Szenario. Typische Seed-Daten können z.B. sein:

  • Aktuelle Nachrichtenartikel
  • Finanzberichte
  • Richtliniendokumente
  • Forschungsarbeiten
  • Social-Media-Diskussionen
  • Fiktive Geschichten

Das Material wird hochgeladen, das Vorhersageziel in natürlicher Sprache beschrieben. MiroFish konstruiert auf Basis dieser Daten eine digitale Umgebung, in der Agenten das Szenario ausspielen.

MiroFish Workflow: Wie die Simulationspipeline funktioniert

MiroFish transformiert reale Daten Schritt für Schritt in eine dynamische Simulationsumgebung. Die wichtigsten Phasen im Überblick:

1. Wissensgraphen-Konstruktion

  • Seed-Informationen aus verschiedenen Quellen extrahieren (z.B. News, Finanzdaten, Politik, Studien, Social Media)
  • Aufbau eines Wissensgraphen (GraphRAG-Architektur): Entitäten, Beziehungen, Kontext
  • Injektion von individuellem und kollektivem Agenten-Gedächtnis

2. Umgebungsgenerierung

  • Entitäten- und Beziehungs-Extraktion
  • Generierung von Agenten-Personas
  • Aufbau sozialer Netzwerke
  • Konfiguration von Simulationsparametern

3. Parallele Simulationsausführung

  • Tausende Agenten agieren gleichzeitig
  • Simulation sozialer Interaktionen, Reaktionen auf Ereignisse
  • Automatisches Speichern und Aktualisieren von Agenten-Gedächtnissen
  • Dynamische Weiterentwicklung der Umgebung

4. Berichtserstellung

  • Nach mehreren Simulationszyklen analysiert der ReportAgent die Ergebnisse.
  • Erstellung eines strukturierten Berichts: Schlüsselergebnisse, Trends, Verhaltensmuster, Risiken

5. Tiefe Interaktion mit der Simulation

  • Direkte Interaktion mit Agenten: Gespräche, Entscheidungsfragen, Analyse sozialer Dynamik
  • Kommunikation mit dem ReportAgent für tiefergehende Analysen oder weitere Fragen
  • Flexible, explorative Nutzung der Simulationsumgebung

Schnellstart: MiroFish lokal ausführen

Entwickler können MiroFish lokal per Quellcode- oder Docker-Bereitstellung testen. Im Folgenden eine schnell umsetzbare Schritt-für-Schritt-Anleitung.

Systemanforderungen

Vorab müssen folgende Tools installiert sein:

Tool Version Zweck
Node.js 18+ Frontend-Laufzeitumgebung
Python 3.11–3.12 Backend-Laufzeitumgebung
uv Neueste Python Paketmanager

Installationen prüfen:

node -v
python --version
uv --version
Enter fullscreen mode Exit fullscreen mode

Schritt 1: Umgebungsvariablen konfigurieren

Kopiere das Konfigurations-Template:

cp .env.example .env
Enter fullscreen mode Exit fullscreen mode

Bearbeite .env und trage die benötigten API-Schlüssel ein.

LLM API-Konfiguration

Beispiel:

LLM_API_KEY=your_api_key
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
LLM_MODEL_NAME=qwen-plus
Enter fullscreen mode Exit fullscreen mode

Empfehlung: Starte mit Simulationen unter 40 Runden, da größere Simulationen viel Rechenleistung benötigen.

Speichersystem-Konfiguration

Für Agenten-Langzeitgedächtnis:

ZEP_API_KEY=your_zep_api_key
Enter fullscreen mode Exit fullscreen mode

Kostenloses Zep Cloud-Konto reicht für erste Tests aus.


Schritt 2: Abhängigkeiten installieren

Alles mit einem Befehl installieren:

npm run setup:all
Enter fullscreen mode Exit fullscreen mode

Oder einzeln:

Node-Abhängigkeiten:

npm run setup
Enter fullscreen mode Exit fullscreen mode

Python-Backend:

npm run setup:backend
Enter fullscreen mode Exit fullscreen mode

Dabei wird automatisch eine virtuelle Python-Umgebung erstellt.


Schritt 3: Die Plattform starten

Frontend und Backend gemeinsam starten:

npm run dev
Enter fullscreen mode Exit fullscreen mode

Danach erreichbar unter:

Einzeln starten:

npm run backend   # Nur Backend
npm run frontend  # Nur Frontend
Enter fullscreen mode Exit fullscreen mode

Docker-Bereitstellung

MiroFish kann alternativ in einer Docker-Umgebung gestartet werden.

  1. Umgebungsvariablen konfigurieren:

    cp .env.example .env
    
  2. Container starten:

    docker compose up -d
    

Standard-Ports:

  • 3000: Frontend
  • 5001: Backend-API

Die bereitgestellte Docker-Konfiguration enthält optional alternative Quellen für schnelleren Container-Download.

Abschließende Gedanken

Schwarmintelligenz-Plattformen wie MiroFish zeigen, wie KI soziale Prozesse simulieren kann. Für Entwickler eröffnen sich Möglichkeiten, komplexe Szenarien zu testen – von Marktreaktionen über politische Meinungsbildung bis zur Analyse von Informationsverbreitung. Auch wenn keine Simulation die Realität perfekt abbilden kann, bieten Multi-Agenten-Simulationen einen leistungsfähigen Werkzeugkasten für Forschung, Prognose und Entscheidungsunterstützung.

MiroFish ist Open Source und aktiv in der Entwicklung – ideal für Entwickler, die mit Multi-Agenten-KI experimentieren und eigene Simulations-Pipelines aufbauen möchten.


Top comments (0)