Installation

System Requirements

Component	Minimum	Recommended
OS	Debian 11+ / Ubuntu 22.04+	Debian 12
Erlang/OTP	27	28
LuaJIT	2.1	2.1
RAM	4 GB	16 GB+
Disk	10 GB	50 GB+ (with models)
CPU	2 cores	8+ cores (for inference)

Install Erlang/OTP

# Using asdf (recommended)
asdf plugin add erlang
asdf install erlang 28.4
asdf global erlang 28.4

# Or from Erlang Solutions
wget https://packages.erlang-solutions.com/erlang-solutions_2.0_all.deb
sudo dpkg -i erlang-solutions_2.0_all.deb
sudo apt-get update
sudo apt-get install esl-erlang

Install LuaJIT

# From source
git clone https://github.com/LuaJIT/LuaJIT.git
cd LuaJIT
make && sudo make install

Build ZERG

git clone https://github.com/spacebeam/zerg.git
cd zerg

# Build server
cd server && rebar3 compile && rebar3 release

# Build CLI
cd ../zerg-cli && bash build/build.sh

# Build Mango (optional, for auth)
cd ../mango && pip install -r requirements.txt

Docker Compose (Infrastructure)

cd infra
docker compose up -d

This starts Forgejo, Jenkins, Woodpecker CI, Grafana, and Tempo.

Configuration

See Configuration Reference for all options.