---
title: "Installation"
description: "Install LangSight on macOS, Linux, or Windows."
---

## Requirements

- Python 3.11 or higher
- pip or uv
- Docker + Docker Compose (for server deployments)

## Install with uv (recommended)

[uv](https://docs.astral.sh/uv/) is the fastest Python package manager. It installs LangSight as a global tool so `langsight` is available everywhere:

```bash
# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install LangSight
uv tool install langsight

# Verify
langsight --version
```

## Install with pip

```bash
pip install langsight
langsight --version
```

## Install from source

```bash
git clone https://github.com/LangSight/langsight
cd langsight
uv sync
uv run langsight --version
```

## Verify installation

```bash
langsight --help
```

```
Usage: langsight [OPTIONS] COMMAND [ARGS]...

  LangSight — Agent runtime reliability platform.

Commands:
  costs          Show MCP tool call cost attribution.
  init           Auto-discover MCP servers and generate .langsight.yaml.
  investigate    Investigate MCP failures and attribute root causes.
  mcp-health     Check the health of all configured MCP servers.
  monitor        Continuously monitor MCP servers and alert on state changes.
  security-scan  Scan MCP servers for security vulnerabilities.
  serve          Start the LangSight REST API server.
```

## Platform support

| Platform | Status |
|----------|--------|
| macOS (arm64, x86_64) | ✅ Supported |
| Linux (x86_64, arm64) | ✅ Supported |
| Windows (WSL2) | ✅ Supported |
| Windows (native) | ⚠️ Untested |

## First-run bootstrap (server deployments)

When running with PostgreSQL or ClickHouse, set these environment variables before starting the stack. LangSight creates the admin user and the "Default" project automatically on first run.

```bash
# Required on first run
LANGSIGHT_ADMIN_EMAIL=you@example.com
LANGSIGHT_ADMIN_PASSWORD=your-secure-password
AUTH_SECRET=a-long-random-string-32-chars-min

# ClickHouse credentials
CLICKHOUSE_USER=langsight
CLICKHOUSE_PASSWORD=your-clickhouse-password
```

After the first run, apply database migrations:

```bash
uv run alembic upgrade head
```

<Note>
  If `LANGSIGHT_ADMIN_EMAIL` or `LANGSIGHT_ADMIN_PASSWORD` are not set, the API starts but no admin account exists and login will fail. The stack will log a warning and refuse to start in strict mode.
</Note>

## Upgrading

```bash
# uv
uv tool upgrade langsight

# pip
pip install --upgrade langsight
```

## Uninstalling

```bash
# uv
uv tool uninstall langsight

# pip
pip uninstall langsight
```
