Skip to main content
Install Sovara in two parts: the desktop app for inspecting runs, and the SDK for the language your agent is written in.

​
Demo Sovara Desktop App

The desktop app gives you a local workspace for recording, inspecting, and improving agent runs. Choose the installer for your operating system.
Version 0.3.4
macOS

For Apple Silicon and Intel Macs.

Apple Silicon (.dmg)Intel Mac (.dmg)
Windows

For Windows machines.

Windows (.exe)
Linux

For Debian/Ubuntu and Fedora/Red Hat-based distributions.

Debian / Ubuntu Intel/AMD (.deb)Debian / Ubuntu arm64 (.deb)Fedora / Red Hat Intel/AMD (.rpm)Fedora / Red Hat arm64 (.rpm)
After the installer finishes, open Sovara and keep the desktop app running.

​
Python SDK

Install sovara in the Python environment where your agent runs. If you use uv, add it to the project. If you manage the environment directly, install it with pip. 
uv add sovara

​
TypeScript SDK

Install @sovara/runner in the Node.js project where your agent runs. 
npm install @sovara/runner

​
Sovara CLI

Sovara’s CLI is meant to speed up agent development with Codex and Claude Code by giving them terminal access to run inspection, trace queries, logs, and shared skill guidance. The Python SDK and TypeScript SDK do not install the terminal command. Install the Sovara CLI separately when you (or any coding assistant) want to run commands such as sovara record, sovara status, and sovara probe. 
curl -fsSL https://apps.sovara-labs.com/cli/install.sh | sh
Open a new terminal window after installation if sovara is not found immediately. After the CLI is installed, install the Sovara skill for Codex and Claude Code: 
sovara install-skill --target both