Get started

Quick start

$ pip install aether-robotics
$ aether --calibrate          # walk GPIO pins, label actuators
$ aether --mode agent         # natural-language control on live hardware

A typical agent session:

objective> move forward and stop about 5 cm before the wall
[PLAN]  [LLM]  drive_until_obstacle
[EXEC]  drive_until_obstacle(target_cm=5, max_speed=25)
[OK]    success=True  stop_reason="obstacle at 5.2 cm"

No hardware? Try the simulator:

$ aether --mode sim --scenario obstacles --render

Raspberry Pi + PiCar-X

$ sudo raspi-config                          # enable I2C, SPI, Serial
$ sudo apt update && sudo apt install -y python3-pip git i2c-tools
$ git clone https://github.com/sunfounder/robot-hat.git
$ git clone https://github.com/sunfounder/picar-x.git
$ cd robot-hat && sudo python3 install.py
$ cd ../picar-x && sudo python3 setup.py install
$ pip install aether-robotics --break-system-packages
$ export PATH="$HOME/.local/bin:$PATH"
$ export ANTHROPIC_API_KEY="your-key"
$ aether --mode agent