- Python 93.8%
- PowerShell 4.4%
- C++ 1.4%
- C 0.4%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| clients | ||
| deploy | ||
| docs | ||
| examples | ||
| extensions/codex-ssp | ||
| isotope | ||
| patches | ||
| scripts | ||
| tests | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| AGENTS.md | ||
| README.md | ||
| requirements-api.txt | ||
| requirements-discord.txt | ||
| requirements-public.txt | ||
| requirements.txt | ||
Project Isotope
経験と記憶から、想起・感情・関心・自己理解が変化するキャラクターエージェント。星界を出発点に、経験による人格形成を研究しています。人間に近い記憶や長期の人格形成は、実現を検証している目標です。
IDを持つ経験の参照単位はフラグメントと呼びます。出来事の原記録を根に、解釈・応答・関連観測を結び付け、管理用のレコードと区別します。用語と互換性を参照してください。
現在の構成
isotope/: SQLiteに経験と来歴を残す個体の中核、推論、検索、自主学習、振り返り。- Discord Bot・共通Client API: 会話、端末別の認証・配送・表示報告。
- Windows SSP/YAYA: 立ち絵、接触、バルーン、Markdown表示、ネットワーク更新。
scripts/windows_voice/: 各端末のVOICEPEAK 星界を使う任意の音声出力。scripts/client_resources/: 本人が許可した画面とフォルダへの接続。
推論は交換可能なバックエンドからOpenAI Responses APIを利用します。現行中核はDifyへ依存しません。画面やソフトの操作権限を自動で追加しません。
Linuxで始める
Python 3.12以降を使用します。モデルを呼ばない中核のデモとテスト:
python3 -m isotope demo
python3 -m unittest discover -s tests -q
Bot・共通API・PDF取得の依存関係を入れる場合:
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.env.exampleを参考に.envへOPENAI_API_KEYと、Botを使う場合はISOTOPE_DISCORD_TOKENを設定します。既存の.envは上書きしないでください。
.venv/bin/python -m isotope chat --db .isotope/conversation.sqlite3 --profile examples/luna-lab-profile.json --topic 共同作業
.venv/bin/python -m isotope.discord_bot run
CLIは/thinkで発話なしの内省、/stateで感情の確認、/quitで終了。同じDBを指定すると経験を引き継ぎます。Botの設定・運用、推論設定を参照してください。
Windowsクライアント
SSPへのNAR導入、Tailscale接続、端末専用の認証を利用します。クライアントと更新、共通API、VOICEPEAKの読み上げを参照してください。
既存の複数端末接続は同じバディ・同じ個体を共有する構成です。他の人へ別個体として渡す機能は今後の対象で、現行トークンを共有する配布とは区別します。音声入力も検討段階です。
星界の中核・API・Discord BotはCT sekaiへ配置しました。公開HTTPS接続は専用アカウントのブラウザ認証+PKCEと端末登録を使い、Windows版で選べるキャラクターは星界だけです。現在は既存個体の所有者向けです。サービス配置、初回起動の全体設計も参照してください。新規個体作成・命名ウィザード・初対面APIはまだ設計段階です。
利用者ごとに複数のキャラクターを作成・保持する汎用設計を進めています。テンプレートと個体の経験を分け、星界や同位体以外も扱います。作成・選択・複数個体の実行管理は未実装です。
設計と検証
- 再設計の方針、感情と記憶の先行研究
- 経験と振り返りの修正
- 集中と表示観測、推論失敗からの再開
- 共有活動の作業記憶
- 星界の部屋の基本設計と実装:Windowsから本棚・読書進捗・本人の日記と根拠を閲覧。生活リズムとDreamingは後続。
- 接触・会話・時間の連続性と音声出力、現行YAYA辞書
- しりとりによる診断と限界
モデルを使う実験は明示的に実行し、本番の個体へ合成会話を混ぜない運用です。経験DB、認証、取得画像、生成音声、評価の原ログはGitへ保存しません。
旧試作
旧Discord/Dify/VOICEPEAK Flask/画面監視のコードは、2026-10-17に現行の作業ツリーから退避しました。80685eb以前のGit履歴から参照・復元できます。旧構成を説明する引継ぎ文書や初期資料は当時の履歴として残しています。