Installation

Install EOS on the central laboratory computer. You need Python 3.11+, uv, Node.js and npm for the web UI, and Docker Compose for PostgreSQL and S3-compatible storage. See Infrastructure Setup before connecting other lab computers.

Install uv and EOS

Linux/macOS

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

Windows

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

Clone the repository and install dependencies:

git clone https://github.com/UNC-Robotics/eos
cd eos
uv sync --all-groups

Activate the virtual environment in every terminal before running EOS commands:

Linux/macOS

source .venv/bin/activate

Windows

.venv\Scripts\Activate.ps1

Configure and Start

The setup wizard writes the configuration and can bootstrap Zitadel for Authentication & Authorization. Then start the infrastructure services and EOS, which initializes the database on its first run:

eos setup
eos services up
eos start

In another terminal, open the EOS repository and activate the virtual environment using the command above. Then install the web UI dependencies and start it:

cd web_ui
npm install
eos start ui

The UI defaults to http://localhost:3000. The example configuration loads multiplication_lab and optimize_multiplication. Change config.yml to load your packages.

Manual Configuration

If you do not use the wizard, copy and edit the templates:

cp .env.example .env
cp config.example.yml config.yml
cp web_ui/.env.example web_ui/.env

Then initialize services and start the orchestrator:

eos services up
eos db init
eos start

Install and start the UI as above. For a Docker UI deployment, copy and edit web_ui/.env.docker.example as web_ui/.env.docker, then run docker compose up -d from web_ui.

Update EOS

eos update

This pulls master, syncs dependencies, and runs database migrations while preserving user package code and dependencies. Use eos update --help for options.