Edge service for the Centrifuge machine.

• Runs the centrifuge machine edge service.
• Connects to NATS and translates commands into machine actions.
• Communicates with the centrifuge device over the network (IP).

• Docker and Docker Compose installed
• Python 3.14+ and uv (for baremetal mode)
• centrifuge device reachable on the network

cp .env.example .env

Edit .env and configure:

• MACHINE_ID
• NATS_SERVERS
• WS_URL

Build and start:

docker compose up -d --build

View logs:

docker compose logs -f

Stop:

docker compose down

uv sync
uv run python main.py

Login:

echo $GITHUB_TOKEN | docker login ghcr.io -u USERNAME --password-stdin

Build:

docker compose build

Push:

docker push ghcr.io/PUDAP/centrifuge-edge:latest

Or with Compose:

docker compose push