Skip to main content

Golem Documentation

Michael Bernstein

Installation & Environment Setup

Golem requires Python >= 3.14 and operates with zero Node.js, npm, or external binary dependencies.

Standard Installation

Install Golem directly into your project virtual environment via pip:

# Create and activate an isolated virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install golem-docs
pip install golem-docs

Verify your installation:

golem --version

Installing from Source

To contribute or develop plugins against the latest bleeding-edge commits:

git clone https://github.com/webmaven/golem.git
cd golem
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Building Golem's Own Documentation

Golem is self-hosting: it uses itself to build its own documentation site.

The [docs] optional-dependency group declares golem-docs as its own dependency. When installed in editable mode, pip satisfies that self-reference with the editable install already in the environment — no duplicate copy is created.

# Install in editable mode with the docs extra (self-hosting)
pip install -e ".[docs]"

# Build the Golem documentation site
golem build

pip install -e ".[dev,docs]" installs both the development toolchain and the self-hosting docs dependency in a single command, which is the recommended setup for Golem contributors.