BioShake driver and edge service.

• Runs the bioshake machine edge service.
• Connects to NATS and translates commands into machine actions.
• Communicates with the bioshake device over serial.

• Docker and Docker Compose installed
• Python 3.14+ and uv (for baremetal mode)
• bioshake device reachable on the serial port

From repo root:

cp .env.example .env

Edit .env and configure:

• MACHINE_ID
• NATS_SERVERS
• BIOSHAKE_PORT

All commands below are run from repo root.

Build and start:

docker compose up -d --build

View logs:

docker compose logs -f

Stop:

docker compose down

From repo root:

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/bioshake-edge:latest

Or with Compose:

docker compose push