biologic

Monorepo for the Biologic edge service.

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

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

From repo root:

cp edge/.env.example edge/.env

Edit edge/.env and configure:

• MACHINE_ID
• NATS_SERVERS
• BIOLOGIC_IP

All commands below are run from repo root.

Build and start:

docker compose -f edge/compose.yml up -d --build

View logs:

docker compose -f edge/compose.yml logs -f

Stop:

docker compose -f edge/compose.yml down

From repo root:

uv sync --all-packages
uv run --package biologic-edge python edge/main.py

Login:

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

Build:

docker compose -f edge/compose.yml build

Push:

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

Or with Compose:

docker compose -f edge/compose.yml push

• Docker build context is workspace root (.. in edge/compose.yml).
• Dockerfile path is edge/Dockerfile.