安装

从 PyPI 或源码安装 QitOS，并按需启用 models 与 benchmarks extras。

QitOS 当前处于 Alpha 阶段。核心 AgentModule + Engine 内核、tracing 与规范化 examples 相对稳定；更高层 API 仍可能在版本间演进。用于生产时请固定版本。

​

环境要求

QitOS 需要 Python 3.10 及以上。当前测试覆盖 Python 3.10、3.11 和 3.12。

如果你还没有远程模型 API，可以先看 前置准备，里面整理了推荐平台、API Key 获取方式和最小连通性验证。

​

标准安装

从 PyPI 安装核心框架：

pip install qitos

核心安装包含：

• AgentModule + Engine 内核
• qita 可观测性工具
• kit 工具箱模块

它默认不包含 OpenAI client，也不包含 benchmark dataset loaders。

如果你想马上运行最小 coding-agent quickstart，直接安装 pip install "qitos[models]" 就可以。

​

可选 extras

通过 extras 按需加入模型支持、benchmark 依赖，或一次性安装全部组件。

模型支持

pip install "qitos[models]"

Extra	增加的内容
models	openai>=1.0.0，用于 OpenAI-compatible model endpoints
benchmarks	datasets、huggingface_hub 等 benchmark adapters 依赖
all	以上全部

如果你刚开始接触 QitOS，最推荐 pip install "qitos[models]"。这足以跑通最小 coding-agent quickstart 和大部分 examples。

​

从源码安装

克隆仓库后，以 editable 模式安装，并带上开发依赖：

git clone https://github.com/Qitor/qitos.git
cd qitos
pip install -e ".[dev,models,benchmarks]"

dev extra 会安装 pytest、black、flake8、mypy 以及 QitOS 团队使用的打包工具。

​

验证安装

确认包是否安装成功，并查看版本：

python -c "import qitos; print(qitos.__version__)"

你应该能看到：

0.3.0

也可以顺手验证最小 coding agent 与两个 CLI 都已经进入 PATH：

qit demo minimal
qit --help
qita --help

​

接下来推荐

快速开始

2 分钟内运行你的第一个 agent

核心概念

理解 AgentModule、Engine、State 和 Tools