PUDA edge service for BioLogic potentiostats (SP, VSP, VMP, and similar EC-Lab instruments).
Connects to NATS, advertises electrochemical techniques as machine commands, and talks to the instrument over Ethernet.
- Windows host with the BioLogic EC-Lab /
puda-biologicnative libraries - Python 3.14+ and
uv(for baremetal) - Docker and Docker Compose (optional)
- Potentiostat reachable on the network
From repo root:
cp .env.example .envEdit .env and fill in:
MACHINE_ID— machine identifier (default:biologic)NATS_SERVERS— comma-separated NATS server URLsBIOLOGIC_IP— Ethernet address of the potentiostat
All commands below run from repo root.
Build and start:
docker compose -f compose.yml up -d --buildView logs:
docker compose -f compose.yml logs -fStop:
docker compose -f compose.yml downuv sync
uv run python main.pyOn Windows you can also double-click start_edge.bat.
Login:
echo $GITHUB_TOKEN | docker login ghcr.io -u USERNAME --password-stdinBuild and push:
docker compose -f compose.yml build
docker compose -f compose.yml push- Docker build context is the repository root.
- Dockerfile path is
Dockerfile. MACHINE_IDin.envis used for NATS subject routing and Docker image/container naming.- The EC-Lab driver is Windows-only. Linux can load the edge process but cannot talk to hardware.