快速开始

在 2 分钟内运行你的第一个 QitOS 最小编程智能体，并用 qita 检查它。

本页会带你从零开始，搭建一个模型驱动的最小编程智能体（coding agent），直到可视化查看追踪记录（trace），全程大约 2 分钟。

QitOS 运行时（runtime）的实际效果如下：

如果你还没有远程模型服务和 API 密钥，建议先阅读 前置准备。其中说明了去哪里注册、如何创建 API 密钥，以及如何验证兼容 OpenAI 的服务商（provider）是否可用。

​

前置条件

• Python 3.10 或更高版本
• pip
• 一个兼容 OpenAI 的 API 密钥

​

操作步骤

1. 安装 QitOS

   pip install "qitos[models]"
   
2. 设置服务商配置

   export OPENAI_API_KEY="sk-..."
   export OPENAI_BASE_URL="https://api.siliconflow.cn/v1/"
   export QITOS_MODEL="Qwen/Qwen3-8B"
   

   任意兼容 OpenAI 的接口地址都可以使用。如果你不是直接使用 OpenAI，请将 OPENAI_BASE_URL 指向对应的服务商。

3. 运行最小编程智能体

   qit demo minimal
   

   这条命令会先创建一个包含最小缺陷的工作区（workspace），配置真实模型，让最小编程智能体修复缺陷、执行验证，并输出 qita 可识别的追踪记录。你会看到类似输出：

   model_name: Qwen/Qwen3-8B
   workspace: .../playground/minimal_coding_agent
   target_file: buggy_module.py
   trace_run: .../runs/qitos_minimal_coding_<timestamp>
   final_result: Patch applied and verification passed.
   stop_reason: final
   next_step: qita board --logdir runs
   
4. 用 qita 查看运行轨迹

   qita board --logdir runs
   

   在浏览器中打开 http://127.0.0.1:8765。面板（board）会列出日志目录中的所有运行记录，包括步骤数、停止原因和最终结果。点击任意运行记录的 view 查看逐步轨迹，或点击 replay 按钮进行回放（replay）。

   打包好的演示与 examples/quickstart/minimal_agent.py 走的是同一条最小编程智能体路径。想阅读或修改代码，可以从这个示例文件入手。

​

接下来怎么学

你已经跑起了一个最小编程智能体，也看到了它的追踪记录。接下来推荐继续：

构建第一个智能体

从状态、模型、工具、运行到 qita，系统理解最小编程智能体的结构

教程课程

通过 ReAct、PlanAct、Claude Code 风格和安全审计课程递进学习

可观测性

全面了解 qita 面板、回放与导出（export）

基准测试（benchmark）

在 QitOS 内核上运行 GAIA、Tau-Bench 与 CyBench