Skip to main content
Install HoloDesktop CLI from a source checkout and verify the CLI.
holo-desktop is not currently installed from PyPI. Use the GitHub checkout flow below for this release path.

​
Before you start

You need:
  • Git;
  • Python 3.12 or newer;
  • uv.

​
Clone and sync

git clone https://github.com/hcompai/holo-desktop
cd holo-desktop
uv sync
This installs the Python client and its dependencies into the checkout’s virtual environment. It does not install the computer-use agent runtime yet.

​
Check the CLI

uv run holo --help
You should see subcommands such as run, mcp, acp, install, login, whoami, and doctor.

​
What installs later

This checkout installs the Python client only. The first time HoloDesktop CLI needs to run a desktop task, it installs the computer-use agent runtime for you. The runtime is the separate executable that observes the screen, plans actions, clicks, and types. Its binary is named hai-agent-runtime. If the CLI does not find hai-agent-runtime on PATH, it downloads the pinned runtime version and installs it under: 
~/.holo/runtime/
The download is sha256-verified. Most users do not need to manage this directory directly.

​
Check it worked

From the checkout, run: 
uv run holo --help
If the command prints help, the client is installed. If it fails, re-run uv sync from the repo root and make sure you are still inside the holo-desktop checkout.

​
What’s next

Continue to Hosted or local models to choose how the CLI should call a model.