INSTALLATION

A short path from install to useful work.

OpenKyrozen supports Python 3.12 and 3.13. The installer prepares the supported environment and terminal UI for you.

RECOMMENDED · macOS OR LINUX

Install from a terminal.

Run the installer, then launch OpenKyrozen. The first run guides you through provider setup.

Shell

curl -fsSL https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.5/install.sh | sh
kyrozen

WINDOWS POWERSHELL

Use the Windows installer.

PowerShell

irm https://raw.githubusercontent.com/EvanProgramming/OpenKyrozen/v2.0.5/install.ps1 | iex
kyrozen

FIRST LAUNCH

Choose a provider and start in a project.

Launch kyrozen and choose a supported model provider.
Configure a provider key when needed. Keys are kept in environment variables or the encrypted configuration flow.
Ask a question about your project, or select Agent mode when you want it to take actions under the configured approvals.

The installer stores private application state under ~/.kyrozen. A cloud model provider receives the prompt content you send to it; choose a local provider such as Ollama when that fits your setup.

OTHER PATHS

Prefer to work from source?

Clone the repository

For development, install the project dependencies and run the agent from the checkout.

git clone https://github.com/EvanProgramming/OpenKyrozen.git
cd OpenKyrozen
make install
make run

Source repository

Install the verified wheel

Use the project’s published release wheel with uv and Python 3.12.

uv tool install --python 3.12 --force --with fastapi --with uvicorn https://github.com/EvanProgramming/OpenKyrozen/releases/download/v2.0.5/openkyrozen-2.0.5-py3-none-any.whl

Browse releases

See what OpenKyrozen can do.

Learn about the tools, memory, learning system, and safety model.

Explore capabilities