Installation

Up and running in 30 seconds

Download. Extract. Run. Includes CLI, orchestrator, examples, and docs.

Windows
x64 • Full package (CLI + orchestrator)
Download
macOS
Apple Silicon (arm64) • Full package
Download
Linux
x64 • Full package (CLI + orchestrator)
Download
macOS
Intel (x64) • Full package
Download
Linux
ARM64 • Full package
Download

Each full package includes: hil-cli + hil-orchestrator + examples/ + docs/

Or install via the package manager: hilp install hilos

Desktop IDE

HIL LISP IDE

A full-featured desktop IDE for writing, transpiling, and uploading HIL LISP code. Built on Electron with Monaco editor, syntax highlighting, auto-complete, serial monitor, and one-click transpilation. Supports 16+ Arduino libraries.

Windows
x64 • Electron
Download
macOS
Intel (x64)
Download
macOS
Apple Silicon (arm64)
Download
Linux
x64 • Electron
Download

Windows users: run install.bat to install to Program Files with shortcuts.

macOS users: drag "HIL IDE.app" to Applications. Linux users: chmod +x hil-ide && ./hil-ide .

Package Manager

hilp — HIL Package

Install libraries, board support, and examples with one command. Like npm, but for HIL.

Quick Start

hilp init

Creates a hil.json manifest in your project directory.

hilp install hilos-sensors

Installs a package and its dependencies into .hil/.

hilp search avr
hilp list

Available Packages

hilos-core
Core runtime & base libraries
hilos-avr
AVR board support (Uno, Nano, Mega)
hilos-esp32
ESP32 board support
hilos-sensors
DHT, BMP280, ultrasonic, LM35
hilos-displays
LCD, NeoPixel, TFT, MAX7219
hilos-motors
Servo, DC motor, PID
hilos-examples
Example projects & tutorials
hilos-crumb
CRUMB simulator integration

Registry: registry.mediahubnetwork.net • Publish your own packages with hilp publish

Supported Boards

Arduino Uno
ATmega328P
Arduino Nano
ATmega328P
Arduino Mega
ATmega2560
Nano Every
ATmega4809
Leonardo
ATmega32U4
ESP32
Xtensa LX6
ESP32-S2/S3
Xtensa LX7
ESP8266
Xtensa LX106
RP2040
Raspberry Pi Pico
Pico W
RP2040 + WiFi
Seeed XIAO
SAMD21
SparkFun
RedBoard

Supported Libraries (USE-*)

USE-WIRE
I2C communication
USE-SERVO
Servo motor control
USE-SPI
SPI communication
USE-SD
SD card read/write
USE-NEOPIXEL
WS2812B LEDs
USE-DHT
Temperature/humidity
USE-LCD
I2C LCD display
USE-MP3
DFPlayer Mini audio
USE-RTC
DS1307 real-time clock
USE-BMP280
Pressure/temperature sensor
USE-MAX7219
7-segment LED driver
USE-MOTOR
AFMotor DC motors
USE-TFT
TFT display
USE-SOFTWARESERIAL
Software serial port
USE-HCSR04
Ultrasonic distance
USE-LM35
Temperature sensor

Quick Start

1

Download & Extract

Download the archive for your platform. Extract it anywhere, there's no installer.

2

Verify it works

bin\hil-cli.exe --help
chmod +x bin/hil-cli-darwin-arm64 && bin/hil-cli-darwin-arm64 --help
chmod +x bin/hil-cli-linux-amd64 && bin/hil-cli-linux-amd64 --help
3

Run your first example

hil-cli simulate examples/01-getting-started/hello-world.hil

You should see:

Output
{"type":"ready","msg":"Connected on none"} Hello, HIL-OS! Welcome to Hardware-in-the-Loop programming.
4

Try more examples

hil-cli simulate examples/08-projects/morse-sos.hil
hil-cli simulate examples/08-projects/state-machine.hil

Build from Source

If you have Go 1.21+ installed, you can build from source:

1

Clone the repository

git clone https://github.com/user/hil-os.git
2

Build the CLI

cd hil-cli && go build -o hil-cli .
3

Build the orchestrator

cd firmware && go build -o ../bin/hil-orchestrator .

VS Code Extension

Install syntax highlighting and snippets for HIL:

hil-cli install-vscode

Or install manually:

code --install-extension vscode-extension/hil-lisp-1.0.0.vsix

Requirements

ComponentRequired?Notes
HIL CLIYesPre-built or compiled from source
Go 1.21+OptionalOnly needed to build from source
Arduino boardOptionalOnly for real hardware deployment
CRUMB SimulatorOptionalFree circuit simulator for visual testing
VS CodeOptionalRecommended for syntax highlighting

Troubleshooting

Windows SmartScreen: If Windows blocks the .exe, click "More info" → "Run anyway". The binary is not signed.
macOS Gatekeeper: If macOS blocks the binary, run xattr -d com.apple.quarantine bin/hil-cli-* in Terminal.
Linux permissions: If you get "permission denied", run chmod +x bin/hil-cli-*.