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 run 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:

​
Connect to Sovara

Check the app environment already configured for the CLI:
  • If sovara status succeeds, keep using that environment. You do not need to install the desktop app unless you want a local desktop workspace.
  • For a local desktop workspace, install and open the desktop app below, sign in, and run sovara status again.
  • For a remote or team deployment, set SOVARA_APP_SERVER_URL for CLI app commands and run sovara status again.
  • For a headless or CI agent host, the desktop app is not required. Configure the execution-server URL and agent token through the Python API reference or TypeScript API reference.

​
Sovara desktop app for local use

The desktop app gives you a local workspace for recording, inspecting, and improving agent runs. 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 and sign in, then verify the local connection:
Keep the desktop app running while using the local workspace. In platform mode, the CLI and SDKs use the signed-in desktop session instead of asking for an 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.