Repository navigation
Home
Copper is a deterministic robotics runtime and SDK written in Rust. Define your robot's task graph in configuration, then build, run, record, and replay it on targets from Linux to bare metal.
Read the Copper book for tutorials and a guided tour, from your first project through Copper's core concepts. Use this wiki to look up configuration, runtime behavior, and development tools.
Release notes cover changes between versions and migration guidance.
| Topic | What it covers |
|---|---|
| Application overview | Project structure and a minimal task graph. |
| Project templates | Scaffold a new Copper project. |
| Build and deploy | Build artifacts and deployment. |
| Supported platforms | Desktop, SBC, and embedded targets. |
| Bare-metal development | Run Copper on microcontrollers. |
| Topic | What it covers |
|---|---|
| Runtime overview | Execution model and SDK capabilities. |
| Task lifecycle | Task execution, lifecycle hooks, and state. |
| Bridges | Connect Copper to external systems and protocols. |
| Resources | Wire hardware and shared services into tasks and bridges. |
| SDK features | Crate features and how to enable them. |
| Configuration | What it covers |
|---|---|
| RON reference | Configuration fields for tasks, messages, and connections. |
| Modular configuration | Split configurations into reusable files. |
| Graph and mission visualization | Render task graphs and mission definitions. |
| Topic | What it covers |
|---|---|
| Task automation with just | Build and development helpers. |
| Reading unified logs | Inspect recorded messages and runtime logs. |
| Self-describing logs | Startup catalogs, metadata rollover, and offline decoding. |
| Remote debugging | Inspect recorded runs through the debug API. |
| Python support | Work with Copper from Python. |
| Benchmarks | Performance measurements and comparisons. |
| Task Lifecycle | Build and Deploy | Missions |
|---|---|---|
 |
 |
 |
| Resource | What it provides |
|---|---|
| Component catalog | Browse available components. |
| API documentation | Published Rust API reference. |
| Development API documentation | Documentation built from the master branch. |
| cu29 on crates.io | Published crate versions. |
| FAQ | Answers to common questions. |
| Project | Where to go |
|---|---|
| Source code | The Copper repository. |
| Contributing guide | How to contribute changes. |
| Contribution ideas | Larger projects to collaborate on. |