Repolode
XiaoLuoLYG

XiaoLuoLYG/GOD

LLMエージェントの社会シミュレーションを操作するブラウザベースの管制室。町の動きを一時停止し、質問や介入を行い、ステップごとに再生できます。

スター
1,228
フォーク
136
未解決の Issue
9
最終コミット
18 日前

これは何?

GODは、言語モデルを使ったエージェント社会シミュレーション向けのローカル管制室です。シミュレーションを眺めるだけでなく、任意のステップで一時停止したり、再生位置を調整したり、自動再生したりできます。また、住民一人、グループ、町全体に質問を投げかけ、エージェントが次のターンで読む指示を注入できます。

ローカルのFastAPIバックエンド、React/ViteのブラウザUI、ローカルWebSocketで接続する別プロセスのエージェントランタイムで構成されています。セットアップウィザードでOpenAI互換のモデルエンドポイント、シナリオ、エージェントのプロファイルを設定し、実験を開始できます。実験、マップ、エージェントセットはZIPパックとしてエクスポート・インポートできます。

TiledベースのピクセルタウンとPKUキャンパスマップを使った組み込み実験が2つ付属しています。また、インストールもAPIキーも不要で、GitHub Pages上で動作するブラウザ専用のリプレイも利用できます。

主な機能

  • 01実行中または記録済みのシミュレーションをステップ単位で一時停止、スクラブ、自動再生できます。
  • 02実行中にエージェント一人、グループ、町全体を対象に質問できます。
  • 03エージェントが次のターンで読む指示を注入できます。
  • 04モデル、シナリオ、エージェント生成を設定するブラウザウィザードを利用できます。
  • 05Map StudioとAgent Studioでマップや住民を編集できます。
  • 06実験、マップ、エージェントのパックをZIPファイルとしてインポート・エクスポートできます。

ユースケース

  • スクリプト化された社会シナリオでLLMエージェントがどう振る舞うかを調べる。
  • 介入によってシミュレーション上のコミュニティの結果がどう変わるかを、ステップごとに検証する。
  • 再現可能なエージェントシミュレーションをダウンロード可能なパックとして共有する。
  • エージェントベースの実験に使うカスタムマップや住民プロファイルを試作する。

クイックスタート

  1. 1

    リポジトリをクローンする

    git clone https://github.com/XiaoLuoLYG/GOD.git
  2. 2

    プロジェクトディレクトリに移動する

    cd GOD
  3. 3

    GOD を起動する(macOS/Linux)。セットアップウィザードがブラウザーで開きます

    ./scripts/god.sh start

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

  • ローカルで実行するには、OpenAI 互換のモデル API キーとエンドポイントが必要です。セットアップウィザードで入力を求められます。
  • README には、別のコマンドを使って PowerShell ランチャーから Windows で起動する方法も記載されています。
  • README によると、このツールは言語エージェントの社会を調査するためのものであり、それらが社会的に現実的だと主張するためのものではありません。

トピック

よくある質問

GOD とは?
LLMエージェントの社会シミュレーションを操作するブラウザベースの管制室。町の動きを一時停止し、質問や介入を行い、ステップごとに再生できます。 GODは、言語モデルを使ったエージェント社会シミュレーション向けのローカル管制室です。シミュレーションを眺めるだけでなく、任意のステップで一時停止したり、再生位置を調整したり、自動再生したりできます。また、住民一人、グループ、町全体に質問を投げかけ、エージェントが次のターンで読む指示を注入できます。
GOD は無料で使えますか?ライセンスは?
GOD は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
GOD は今もメンテナンスされていますか?
活発にメンテナンス中。GOD の最終コミットは 2026年10月2日 です。
GOD は何に使えますか?
スクリプト化された社会シナリオでLLMエージェントがどう振る舞うかを調べる。 介入によってシミュレーション上のコミュニティの結果がどう変わるかを、ステップごとに検証する。 再現可能なエージェントシミュレーションをダウンロード可能なパックとして共有する。 エージェントベースの実験に使うカスタムマップや住民プロファイルを試作する。
GOD のインストール方法は?
リポジトリをクローンする: git clone https://github.com/XiaoLuoLYG/GOD.git プロジェクトディレクトリに移動する: cd GOD GOD を起動する(macOS/Linux)。セットアップウィザードがブラウザーで開きます: ./scripts/god.sh start
GOD はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/XiaoLuoLYG/GOD

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト