Prerequisites¶

Lumbergh has a small set of dependencies. Most are likely already on your system.

Required¶

Python 3.11+¶

The backend runs on Python 3.11 or newer.

python3 --version

tmux¶

Terminal session management is built on tmux.

Ubuntu/DebianmacOS

sudo apt install tmux

brew install tmux

git¶

Used for the diff viewer and worktree management. Usually pre-installed on most systems.

git --version

Installation Tool¶

uv (recommended)¶

uv is a fast Python package manager from Astral. It installs CLI tools like Lumbergh in isolated environments, keeping your system Python clean. Think of it like npx or pipx, but faster.

Linux/macOSmacOS (Homebrew)Windows

curl -LsSf https://astral.sh/uv/install.sh | sh

brew install uv

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

For other methods, see the uv installation docs.

Alternative: pip

You can also install with pip if you prefer. Any Python package manager that supports PyPI packages will work.

Development Only¶

Node.js 18+¶

Only required if you're working on Lumbergh itself. Not needed for normal usage.

node --version