666ghj/MiroFish

これは何？

主な機能

• 01アップロードしたシード素材から知識グラフとエージェントのペルソナを構築します。
• 02記憶を持つエージェントが2つのプラットフォーム上で交流する、複数ラウンドのシミュレーションを実行します。
• 03実行中のシミュレーションに変数を投入し、さまざまなシナリオを検証できます。
• 04ReportAgentが予測レポートを生成し、対話形式で内容を確認できます。
• 05シミュレーション内の個々のエージェントと直接チャットできます。
• 06OpenAI互換のLLM APIに対応し、ソースからのデプロイとDockerによるデプロイを利用できます。

ユースケース

• ニュースや政策の発表前に、世論がどのように変化するかをシミュレーションする。
• 小説や物語の別の結末や展開を検討する。
• 金融シグナルや市場シグナルについて、条件を変えたシミュレーションを行う。
• 社会システムにおいて、個々のエージェントの相互作用が集団的な結果を生み出す過程を研究する。

クイックスタート

1. 1

   サンプルの環境設定ファイルをコピーする

   cp .env.example .env
2. 2

   必要な API キー（LLM と Zep）を .env に入力する

3. 3

   すべての依存関係をインストールする

   npm run setup:all
4. 4

   フロントエンドとバックエンドを起動する（フロントエンドは localhost:3000、バックエンドは localhost:5001）

   npm run dev

使う前に知っておきたいこと

• !LLM API キーと Zep Cloud API キーが必要です。また、シミュレーションでは大量のトークンを消費する場合があります。
• !ソースからデプロイするには、Python 3.11～3.12、Node.js 18 以降、および uv パッケージマネージャーが必要です。
• !AGPL-3.0 ライセンスのため、ネットワーク経由で提供する改変版のソースコードを共有する必要があります。

トピック

よくある質問

MiroFish とは？

シード素材からデジタル世界を構築し、ニュース、政策、金融イベントの結果を予測するマルチエージェント群衆シミュレーションエンジン。 MiroFishは、マルチエージェントシミュレーションを利用する予測エンジンです。ニュース記事、政策の草案、金融シグナル、小説などのシード素材をアップロードし、予測したい内容を自然言語で入力します。システムはエンティティと関係性を抽出して知識グラフを構築し、それぞれ異なる人格と記憶を持つエージェントを生成したうえで、2つのプラットフォーム上で複数ラウンドにわたってエージェントが交流するシミュレーションを実行します。

MiroFish は無料で使えますか？ライセンスは？

MiroFish は AGPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

MiroFish は今もメンテナンスされていますか？

活発にメンテナンス中。MiroFish の最終コミットは 2026年10月16日 です。

MiroFish は何に使えますか？

ニュースや政策の発表前に、世論がどのように変化するかをシミュレーションする。 小説や物語の別の結末や展開を検討する。 金融シグナルや市場シグナルについて、条件を変えたシミュレーションを行う。 社会システムにおいて、個々のエージェントの相互作用が集団的な結果を生み出す過程を研究する。

MiroFish のインストール方法は？

サンプルの環境設定ファイルをコピーする: cp .env.example .env 必要な API キー（LLM と Zep）を .env に入力する すべての依存関係をインストールする: npm run setup:all フロントエンドとバックエンドを起動する（フロントエンドは localhost:3000、バックエンドは localhost:5001）: npm run dev

MiroFish はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/666ghj/MiroFish