OpenArm Online Runner

Install

These instructions assume Ubuntu.

1. Install system dependencies

sudo apt-get update
sudo apt-get install -y -V \
  build-essential \
  ffmpeg \
  git \
  python3-dev \
  software-properties-common

sudo add-apt-repository -y ppa:openarm/main
sudo apt-get update
sudo apt-get install -y -V libopenarm-can-dev

2. Install uv

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

3. Clone the code

git clone https://github.com/enactic/openarm-online-runner.git

4. Install Python dependencies

cd openarm-online-runner
UV_PROJECT_ENVIRONMENT=.venv-runner uv sync

5. Configure

The runner reads settings from a .env file in the working directory. Copy .env.example and edit it:

cp .env.example .env
editor .env

6. Build the dataflow

UV_PROJECT_ENVIRONMENT=.venv-runner uv run dora build dataflow.yaml --uv

Run

UV_PROJECT_ENVIRONMENT=.venv-runner uv run python -m openarm_online_runner.runner

Run as a systemd service

systemd/openarm-online-runner-generate-service.sh \
  | sudo tee /etc/systemd/system/openarm-online-runner.service
sudo systemctl daemon-reload
sudo systemctl enable --now openarm-online-runner

Check logs:

journalctl -u openarm-online-runner

License

Licensed under the Apache License 2.0. See LICENSE for details.

Copyright 2026 Enactic, Inc.

Code of Conduct

All participation in the OpenArm project is governed by our Code of Conduct.