Installation

pip

pip install eigenhelm

With the HTTP server:

pip install "eigenhelm[serve]"

uv (no venv required)

uv tool install eigenhelm

From source

git clone https://github.com/metacogdev/eigenhelm.git
cd eigenhelm
uv sync --extra dev --extra serve

Docker

The Docker image runs the evaluation server by default:

docker build -t eigenhelm .
docker run -p 8080:8080 eigenhelm

To use the CLI via Docker, override the entrypoint:

docker run --rm --entrypoint eh -v $(pwd):/code eigenhelm evaluate /code/myfile.py

Verify installation

eh --version

Requirements

• Python 3.11 or later
• Dependencies: tree-sitter, lizard, numpy, scipy (installed automatically)