Getting Started#

Installing Dependencies#

Python Environment Management#

This project uses uv (or its predecessor rye) to manage the Python environment.

To check if rye is already installed, run:

which rye

  • If the command prints a path, rye is available and you can skip this step.

  • If not, we recommend installing uv for new setups. Follow uv’s official installation guide.

For backward compatibility, you may also install rye.

Clone and install dependencies#

$ git clone https://github.com/acies-os/controller.git
$ cd controller
controller$ uv sync

# or, if using rye
controller$ rye sync

Install just#

Install just use your package manager or pre-built binary.

Install zenohd#

For x86_64 linux:

wget https://github.com/eclipse-zenoh/zenoh/releases/download/0.11.0/zenoh-0.11.0-x86_64-unknown-linux-gnu-standalone.zip

For aarch64 linux:

wget https://github.com/eclipse-zenoh/zenoh/releases/download/0.11.0/zenoh-0.11.0-aarch64-unknown-linux-gnu-standalone.zip

For aarch64 macOS:

wget https://github.com/eclipse-zenoh/zenoh/releases/download/0.11.0/zenoh-0.11.0-aarch64-apple-darwin-standalone.zip

To unzip the downloaded file, use the following command:

unzip zenoh-0.11.0-<platform>-standalone.zip

Replace <platform> with the appropriate platform identifier (e.g., x86_64-unknown-linux-gnu, aarch64-unknown-linux-gnu, or aarch64-apple-darwin).

To verify the installed version, run:

./zenohd --version

Ensure the output shows version v0.11.0.