Installation#

Requirements: Python ≥ 3.11 · Supported platforms: macOS, Linux

Note

Windows support is under development. Native Windows installation is not fully supported yet. In the meantime, Windows users should install WSL 2 (Ubuntu) and follow the instructions below inside the WSL terminal.

From Source (Recommended)#

git clone https://github.com/EurekaClaw/EurekaClaw
cd EurekaClaw
pip install -e "."

With Optional Extras#

pip install -e ".[openai,oauth]"

Extra	Enables
`openai`	OpenRouter and local vLLM/Ollama backends
`oauth`	Claude Pro/Max login via ccproxy (no API key needed)
`pdf`	Full-PDF extraction via Docling (`PaperReader`)

Optional System Tools#

EurekaClaw works without any of these — it skips the associated step if a tool is absent.

Tool	Purpose	Install
pdflatex + bibtex	Compile `paper.tex` → `paper.pdf`	TeX Live / MacTeX
Lean4	Formal proof verification	leanprover.github.io
clawhub	Install skills from ClawHub registry	`pip install clawhub`

Note

Docker / sandboxed code execution is listed as an optional tool but is future work — the experiment runner and execute_python tool are not yet safely sandboxed for general use. Keep EXPERIMENT_MODE=false until a future release adds proper sandbox support.

Install Seed Skills#

After installation, copy the bundled seed skills to your local skill bank:

eurekaclaw install-skills

This is a one-time step. Skills are saved to ~/.eurekaclaw/skills/ and automatically used by agents on future runs.

Verify Installation#

eurekaclaw --help
eurekaclaw skills        # lists available seed skills