Skip to main content
QitOS is the torch-flavor framework for agent researchers. Prototype methods, run benchmarks, and inspect long-horizon trajectories on one AgentModule + Engine kernel with built-in qita observability.

​
Two authoring paths

QitOS deliberately keeps two top-level ways to build agents:
  • Research-first: handwrite the prompt, parser, protocol, transport, and tool surface so you can study and optimize the kernel directly.
  • Preset-first: start from family presets and preset tool builders when you want a fast baseline or quick multi-family switching.
The framework is strongest when both paths remain first-class.

Quick Start

Run your first agent in under 2 minutes

Build Your First Agent

Step-by-step walkthrough to build a working agent

Tutorial Track

Learn QitOS through four course-style agent builds

Core Concepts

Understand AgentModule, Engine, State, and Tools

API Reference

Full reference for the public QitOS API

Research-first path

Handwrite prompt, parser, protocol, and tool surface on top of the kernel.

Preset-first path

Use family presets to switch one example across multiple model families.

​
Get up and running

1

Install QitOS

pip install "qitos[models]"
2

Set your provider config

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

Run the minimal coding agent

qit demo minimal
4

Inspect your run with qita

qita board --logdir runs
Open http://127.0.0.1:8765 to view trace, replay, and export your run.

​
What QitOS gives you

Agent Patterns

ReAct, PlanAct, Tree-of-Thought, and Reflexion out of the box

Course-style tutorials

ReAct, PlanAct, Claude Code-style, and security audit lessons

Observability

Built-in tracing with qita board, replay, and HTML export

Benchmarks

GAIA, Tau-Bench, and CyBench adapters on the same kernel

Kit Toolkit

Parsers, memory adapters, toolsets, critics, and planners

Single kernel

One AgentModule + Engine runtime across examples, benchmarks, and production-style agents

Protocol-aware parsers

Prompt format and parser choice are paired on purpose, not left as implicit glue

Long-running context control

History policy, summary history, compact history, and memory adapters for sustained runs

Traceability with qita

Board, replay, and export built on top of structured trace artifacts