Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.langsight.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Requirements

  • Python 3.11 or higher
  • pip or uv
  • Docker + Docker Compose (for server deployments)
uv is the fastest Python package manager. It installs LangSight as a global tool so langsight is available everywhere: 
# 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

pip install langsight
langsight --version

​
Install from source

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

​
Verify installation

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

PlatformStatus
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. 
# Required on first run
LANGSIGHT_ADMIN_EMAIL=[email protected]
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: 
uv run alembic upgrade head
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.

​
Upgrading

# uv
uv tool upgrade langsight

# pip
pip install --upgrade langsight

​
Uninstalling

# uv
uv tool uninstall langsight

# pip
pip uninstall langsight