開発環境セットアップ

リポジトリのクローン

bash

git clone https://github.com/Project-N-E-K-O/N.E.K.O.git
cd N.E.K.O

bash

uv sync

これにより、すべてのPython依存関係がマネージド仮想環境にインストールされます。プロジェクトにはPython 3.11が必要です。

N.E.K.O. は複数の協調するサーバーとして動作します。最低限、メインサーバーとメモリサーバーが必要です：

bash

# ターミナル1 — メモリサーバー
uv run python memory_server.py

# ターミナル2 — メインサーバー
uv run python main_server.py

オプションで、バックグラウンドタスク実行用のエージェントサーバーを起動できます：

bash

# ターミナル3 — エージェントサーバー（オプション）
uv run python agent_server.py

メインサーバーが起動したら、Web UIを開いてAPIキーを設定します：

http://localhost:48911/api_key

お好みのCore APIプロバイダーを選択し、APIキーを入力してください。各プロバイダーの詳細はAPIプロバイダーを参照してください。

メインインターフェースを開きます：

http://localhost:48911

Live2Dモデルを含むキャラクターインターフェースが表示されるはずです。テキストメッセージを送信するか、音声セッションを開始して、すべてが正常に動作することを確認してください。

bash

uv run pytest

テストスイートの構造と特定のテストカテゴリの実行方法については、tests/README.md を参照してください。