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

默认打开 http://localhost:8000。若要操作指定项目，使用 kyrozen --project /path/to/project 或 kyrozen-web --project /path/to/project。直接运行 kyrozen 使用 ~/.kyrozen/workspace 全局工作区。

OpenKyrozen 的主要能力

在工作区中读取和修改文件、运行 Shell、使用 Git、搜索网页、操作浏览器会话、查询项目图和 GitHub。
Ask 与 Plan 只允许读取和网络操作；Agent 执行已接受或明确请求的任务，并继续遵守 capability 与 approval 限制。
支持 18 个常用模型服务商，并支持模型默认值和故障回退。
SQLite 是会话、事件、任务、claims 和学习状态的权威存储；ChromaDB 只是可重建的可选索引。
自学习记录结果证据，只提升经过验证的改进，不会偷偷增加权限或修改模型权重。
Jev Decision 是可选的判断层：检查请求路由、澄清、学习证据、记忆相关性和可疑工具输出；它可以弃权，不会执行或批准工具。

当前运行时提供 46 个工具，其中包括 14 个 Git 工具。完整的工具、endpoint 和 MCP schema 以生成的运行时清单为准。

文档

详细的安装、命令、服务商、安全、存储和 API 文档集中在文档索引中。

主题	文档
安装、升级和恢复	安装指南
命令、模式和工作区	使用指南
运行时流程和安全边界	架构
服务商、环境变量和状态目录	配置
Web、REST 和 MCP	API 指南
命令、权限和本地数据	命令参考 · 安全 · 存储
任务、恢复与扩展	任务 · 历史与回滚 · 扩展
用量与常见问题	费用说明 · 故障排查
自动子智能体、独立上下文与交叉验证	子智能体指南
自学习、记忆和证据	自学习指南
Jev Decision 与校准证据	Jev Decision · System One
与其他开源智能体比较	比较
开发、测试和发布	开发指南
参与贡献	贡献指南

完整服务商模型默认值见服务商指南。历史验证与 benchmark 结果可在报告索引中查阅。

安全与开发

请使用环境变量或加密的 ~/.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 · 简体中文 · 日本語 · 한국어}