Solarian Documentation
Welcome to the Solarian docs. Solarian is a Python framework for building robotics applications: a clean Robot ↔ Server ↔ Controller architecture, real-time multi-process modules, plug-and-play hardware drivers, and an AI agentic controller that turns chat instructions into plans and runs them with your skills as tools — all configured with Hydra.
Get Started
The fastest path from zero to a running robot.
Overview
What Solarian is, the architecture, and the big-picture features.
Installation
Install Solarian on Linux, macOS, or directly on your robot.
Creating a Project
Scaffold a project, add a hardware module, and run it end-to-end.
Core Concepts
Learn the building blocks of every Solarian project.
AI
Give the robot a task in plain language and let an AI agent plan it and run your skills.
Plugins
Extend Solarian with solarian-<name> packages: hardware drivers, whole robots, skills, policies, and CLI commands.
Simulation
Run any robot in a MuJoCo world by flipping a switch — same modules, servos, and YAML.
CLI
Tutorials
One project, followed from an empty folder to a robot that learns a task.
1. Gentle intro to Robotics
Joints, poses, cameras, and the control loop — and the Solarian object each one becomes.
2. Your first Solarian robot
Scaffold a project, write an arm, and drive it in simulation with the keyboard.
3. The real robot
Build the Solarian Arm 1, calibrate the servos, and run the same keyboard on the hardware.
4. Robot skills
Write a skill, install a move skill, and run a pretrained UMI policy.
5. Train a skill
Train on an example dataset, collect your own with Lumi, and run the result.