Skip to main content
QitOS is currently Alpha. The core AgentModule + Engine kernel, tracing, and canonical examples are stable. Higher-level APIs may change between releases. Pin your version in production.

​
Requirements

QitOS requires Python 3.10 or later. It is tested on Python 3.10, 3.11, and 3.12.
Need a remote model API before running LLM-powered examples? Start with Prerequisites for provider suggestions, API key setup, and compatibility checks.

​
Standard install

Install the core framework from PyPI: 
pip install qitos
The core install includes the AgentModule + Engine kernel, the qita observability tools, and the kit toolkit modules. It does not include the OpenAI client or benchmark dataset loaders.
If you want to run the minimal coding-agent quickstart immediately, skip straight to pip install "qitos[models]".

​
Optional extras

Use extras to add support for models, benchmarks, or everything at once. 
pip install "qitos[models]"
ExtraWhat it adds
modelsopenai>=1.0.0 — required to use OpenAI-compatible model endpoints
benchmarksdatasets and huggingface_hub — required for GAIA, Tau-Bench, and CyBench adapters
allAll of the above
If you’re just getting started, pip install "qitos[models]" is the right choice. It gives you everything you need to run the minimal coding-agent quickstart.

​
Source install

Clone the repository and install in editable mode with all development dependencies: 
git clone https://github.com/Qitor/qitos.git
cd qitos
pip install -e ".[dev,models,benchmarks]"
The dev extra adds pytest, black, flake8, mypy, and the build tools used by the QitOS team.

​
Verify your installation

Confirm the package is installed and check the version: 
python -c "import qitos; print(qitos.__version__)"
You should see output like: 
0.3.0
You can also verify the minimal coding agent and both CLIs are on your path: 
qit demo minimal
qit --help
qita --help

​
Next steps

Quickstart

Run your first agent in under 2 minutes

Core concepts

Understand AgentModule, Engine, State, and Tools