voxyn Install

Open robotics OS - Raspberry Pi

Talk to
your
robot.

voxyn is the open source OS layer that lets you control any robot with natural language - on any Raspberry Pi, with any hardware, entirely offline.

Install voxyn Star on GitHub

Open source · Works offline · Any hardware · Natural language · Voice control · Custom skills · REST API · Python native · No cloud

Full freedom. Zero lock-in.

Connect PCA9685, Adafruit Motor HAT, raw GPIO, or your own board - write a driver, register it, and voxyn routes commands for you. A local LLM (Phi-3-mini via llama.cpp) turns speech and text into structured intents: no cloud, no API keys, no account.

Define skills: what happens when someone says “patrol” or “wave hello” - YAML for simple actions, Python when you need full control. A FastAPI REST API lets you steer the robot from any device on the network. Whisper handles voice when you want continuous listening without a wake word. Before anything hits the hardware, safety limits and a validation gate keep speed, angles, and watchdog behaviour within bounds.

How it works

Three steps. Your robot understands you.

  1. Install

    One pip command on any Pi. Works immediately in mock mode - no hardware required to start building.

    pip install voxyn

  2. Configure

    Edit voxyn.yaml. Tell voxyn what’s connected - it handles drivers, I2C, PWM, GPIO.

    hardware:
  drivers:
    - name: wheels
      type: pca9685
      channels:
        left: 0
        right: 1

  3. Command

    Send voice or text. Natural language in, hardware action out - under 60ms on the fast path when a skill matches.

    voxyn start
voxyn command "go forward"
voxyn command "wave hello"

Specification

Hardware support
Any Raspberry Pi - PCA9685, Adafruit Motor HAT, GPIO, custom drivers.
AI model
Phi-3-mini via llama.cpp - runs entirely on-device, no cloud.
Voice recognition
OpenAI Whisper base.en - continuous listening, no wake word.
Command latency
< 60ms - skill match · < 800ms - NLU inference (typical)
Skills system
YAML triggers + Python handlers - define any behaviour, any trigger phrase.
Safety
Hard speed limits, angle constraints, watchdog auto-stop before every hardware command.
API
FastAPI REST on port 8080 - control from any device on the network.
Connectivity
100% offline capable - no internet, no API keys, no accounts.
Language
Python 3.10+ - pip installable, open source, Apache 2.0.

The hardware voxyn was built for.

voxyn runs on any Pi with any board. NeuralHAT brings everything into one - Hailo-8L NPU, 16-channel PWM, 4-mic array, CAN bus, and IMU in a single HAT.

Get notified when available, or write for partnerships and hardware questions.

Ready in 60 seconds.

  1. Install on your Pi - pip install voxyn
  2. Start the server - voxyn start
  3. Send your first command - voxyn command "go forward"

Copy into a terminal on your Pi:

Free forever. Apache 2.0. No account needed.

View full docs on GitHub