Installing the Toolchain
To use Pico de Gallo from a host PC, you need the gallo
command-line tool. That’s it — gallo will speak to the firmware
over USB and you don’t need any extra drivers on most platforms.
There are two ways to get it: pre-built binaries (fastest), or building from source.
Option A — Pre-built Binaries
Pre-built binaries are attached to every application-v* release
on the
Releases
page. Supported triples:
| OS | Architectures |
|---|---|
| Linux | x86_64, aarch64 |
| Windows | x86_64, aarch64 |
| macOS | aarch64 |
Download the right archive for your system, unzip, and put gallo
(or gallo.exe) somewhere on your PATH.
$ gallo --version
gallo 0.8.0
Option B — Build from Source
If your platform isn’t in the table above, or you want to live on
main:
- Install Rust (stable toolchain, 1.90 or newer — the workspace pins MSRV to 1.90).
- Clone the repo:
$ git clone https://github.com/OpenDevicePartnership/pico-de-gallo $ cd pico-de-gallo/crates - Build the CLI:
$ cargo build --release -p gallo - The binary lives at
target/release/gallo(orgallo.exeon Windows). Move or symlink it into a directory on yourPATH.
Tip
On Linux you may want to install the
libudevheaders first sonusbbuilds without extra steps:$ sudo apt install libudev-dev pkg-config
Optional Extras
You only need these if you’re working on Pico de Gallo, not just with it:
- The mdBook source for this book lives under
book/. Build withmdbook build book. - The C FFI library (
pico-de-gallo-ffi) builds a.so/.dylib/.dllshared library plus a generatedpico_de_gallo.hheader. Seecrates/ffi.md. - The Python bindings (
pyco-de-gallo) build with maturin:
See$ pip install maturin $ cd crates/pyco-de-gallo $ maturin develop --releasecrates/python.md.
Next
Now verify your device is talking to the host.