Skip to main content
Install the Sovara CLI first so you can check whether an existing Sovara environment is already available. Then choose a local, remote, or headless setup and install the SDK for your agent’s language.

​
Sovara CLI

Sovara’s CLI gives you terminal access to trace inspection, trace queries, logs, and shared skill guidance. The Python SDK and TypeScript SDK do not install the sovara command.
Open a new terminal window if sovara is not found immediately, then verify the installation:
Install the Sovara skill for Codex and Claude Code:

​
Sovara desktop app

The desktop app gives you a local workspace for recording, inspecting, and improving agent traces. Choose the installer for your operating system.
Latest installers
macOS

For Apple Silicon Macs.

Apple Silicon (.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, leave Local selected, and verify the connection:
Keep the desktop app running while using the local workspace. Switching the desktop app-server connection changes the app server used by the UI and CLI app commands; it does not change an SDK’s execution-server URL or agent token.

​
Python SDK

Install sovara in the Python environment where your agent runs. Use the same package manager that owns your project environment.

​
TypeScript SDK

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