Risk-Aware AI Code Review for Business-Critical Systems
LiveReview LiveReview Explore LiveReview
How to install headroomlabs-ai/headroom. Official installation instructions. Project installation guide. Framework or library installation. Build installation instructions. How to setup and install from GitHub. Installation steps and setup instructions. Official docs and installation instructions GitHub.

headroomlabs-ai/headroom Installation Guide

How to install headroomlabs-ai/headroom. Official project installation instructions and setup guide.

⚡

Automated Install (Recommended)

Quick installation instructions for headroomlabs-ai/headroom. This is the fastest way to complete project installation and setup.

Install via curl

curl -fsSL https://hexmos.com/ipm-install | bash && 
ipm i headroomlabs-ai/headroom
or

Install via npx

npx @hexmos/ipm i headroomlabs-ai/headroom

Prerequisites

Python

language

Version: 3.10+

Docker

containerization

Node.js

language

npm

package_manager

uv

package_manager

pipx

package_manager

Git

version_control

Manual Installation Methods

Manual installation instructions. How to install from GitHub source.

Install via uv (recommended for CLI)

uv tool install --python 3.13 "headroom-ai[all]"

uv tool update-shell

headroom --version

Install via pip (Python package with CLI)

pip install "headroom-ai[all]"

headroom --version

Install via npm (TypeScript SDK only)

npm install headroom-ai

Install via Docker

docker pull ghcr.io/headroomlabs-ai/headroom:latest

Install via pipx (Python with CLI)

pipx install --python python3.13 "headroom-ai[all]"

headroom --version

Install via Source (macOS/Linux)

git clone https://github.com/headroomlabs-ai/headroom.git

cd headroom

uv sync --extra dev

uv run pytest

Post Installation Steps

  • headroom deploy
  • headroom wrap claude
  • headroom proxy --port 8787
  • headroom doctor
  • headroom perf
  • headroom dashboard