OpenKyrozen

実行し、記憶し、検証済みの結果から改善するローカル優先のターミナルエージェント。

インストール

OpenKyrozen は Python 3.12 と 3.13 をサポートします。Python 3.14 は対象外です。

macOS または Linux

curl -fsSL https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.8/install.sh | sh
kyrozen

Windows PowerShell

irm https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.8/install.ps1 | iex
kyrozen

インストーラーは対応する Python 環境、ターミナル UI、~/.kyrozen のプライベート状態を準備します。API key を読み取ったり表示したりしません。

初回起動時にプロバイダーを選び、キーを入力します。例：

export DEEPSEEK_API_KEY=your-key
kyrozen

ソースから実行

git clone https://github.com/EvanProgramming/OpenKyrozen.git
cd OpenKyrozen
make install
make run

軽量な開発環境には make install-core を使います。Windows のソース環境では setup.bat と run.bat を使います。

検証済み release wheel を直接インストール

uv tool install --python 3.12 --force --with fastapi --with uvicorn https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.8/openkyrozen-2.0.8-py3-none-any.whl

クイックスタート

あなた：このプロジェクトを読み、アーキテクチャを説明して
あなた：tests/test_server.py の失敗したテストを修正して
あなた：最新の Python リリース日を検索して
あなた：REST endpoint 追加の計画を作って

よく使うコマンド：

/provider              プロバイダーを切り替える
/mode ask|plan|agent   読み取り専用、計画、実行モードを選ぶ
/project               現在のワークスペースを確認する
/skills                インストール済みスキルを確認する
/learning status       自己学習の状態を確認する
/quit                  終了する

任意の Web UI は次で起動できます：

kyrozen-web

既定の URL は http://localhost:8000 です。特定のプロジェクトを操作する場合は kyrozen --project /path/to/project または kyrozen-web --project /path/to/project を使います。通常の kyrozen は ~/.kyrozen/workspace のグローバルワークスペースを使います。

OpenKyrozen の要点

ファイル、Shell、Git、Web 検索、ブラウザーセッション、プロジェクトグラフ、GitHub を同じワークスペースで扱えます。
Ask と Plan は読み取り・ネットワーク操作だけを許可します。Agent は受理済みまたは明示的に依頼された作業を実行し、capability と approval の制約に従います。
18 個の主要なモデルプロバイダー、モデルの既定値、フォールバックをサポートします。
SQLite がセッション、イベント、タスク、claims、学習状態の正式な保存先です。ChromaDB は再構築可能なオプションのインデックスです。
自己学習は結果の証拠を記録し、検証された改善だけを昇格させます。権限やモデル重みを暗黙に変更しません。
Jev Decision は任意の判断レイヤーです。リクエストのルーティング、確認、学習の証拠、メモリの関連性、疑わしいツール出力を確認します。実行や承認は行わず、必要なら棄権します。

現在のランタイムには 46 個のツールがあり、そのうち Git ツールは 14 個です。ツール、endpoint、MCP schema の正式な一覧は生成されたランタイム一覧です。

ドキュメント

詳しいインストール、コマンド、プロバイダー、安全、保存データ、API のガイドはドキュメント索引から参照できます。

内容	ドキュメント
インストール、更新、復旧	インストールガイド
コマンド、モード、ワークスペース	使用ガイド
ランタイムと安全境界	アーキテクチャ
プロバイダー、環境変数、状態	設定
コマンド、権限、ローカルデータ	コマンド一覧 · セキュリティ · ストレージ
タスク、履歴、拡張機能	タスク · 履歴とロールバック · 拡張機能
使用量、費用、トラブル対応	使用量 · トラブルシューティング
Web、REST、MCP	API ガイド
自動サブエージェント、独立コンテキスト、相互検証	サブエージェントガイド
自己学習、メモリ、証拠	自己学習ガイド
Jev Decision と校正された証拠	Jev Decision · System One
他のオープンソースエージェントとの比較	比較
開発、テスト、リリース	開発ガイド
コントリビュート	貢献ガイド

各プロバイダーの既定モデルはプロバイダーガイドを参照してください。検証やベンチマークの記録はレポート一覧にあります。

セキュリティと開発

プロバイダー資格情報は環境変数または暗号化された ~/.kyrozen_config.json に保存してください。Web サーバーを localhost の外へ公開する場合は KYROZEN_SERVER_TOKEN を設定し、capability と approval を確認してください。

make check
make docs-check
make test
make lint

詳しくは AGENTS.md、設定とセキュリティ、開発ガイドを参照してください。

ライセンス

OpenKyrozen は MIT License で公開されています。

_{English · 简体中文 · 日本語 · 한국어}