<h1 style="color: #b87333;"><img src="https://github.com/copper-project/copper-rs/blob/master/doc/static/cu29.png?raw=true" width="60" /> Copper Runtime & SDK</h1>
[](https://github.com/gbin/copper-project/actions/workflows/general.yml)


[](https://deps.rs/repo/github/copper-project/copper-rs)
[](https://discord.gg/VkCG7Sb9Kw)
[](https://copper-project.github.io/copper-rs)
<blockquote>
ðĪ    
<em style="font-size: 1.2em;">
Copper is to robots what a game engine is to games - build, run, and replay your entire robot deterministically.
</em>
</blockquote>
### Why Copper
<p><strong style="color: #b87333;">ðĶ Rust-first</strong> â ergonomic & safe
<p><strong style="color: #b87333;">⥠Sub-microsecond latency</strong> â zero-alloc, data-oriented runtime
<p><strong style="color: #b87333;">âąïļ Deterministic replay</strong> â every run, bit-for-bit identical
<p><strong style="color: #b87333;">ð§ Interoperable with ROS2</strong> â bridges via Zenoh opening the path for a progressive migration.
<p><strong style="color: #b87333;">ðŠķ Runs anywhere</strong> â from Linux servers, workstations, SBC to bare-metal MPUs
<p><strong style="color: #b87333;">ðĶ Built to ship</strong> â one stack from simulation to production
### Example Applications
| Flying | Driving | Swimming | Spacefaring |
|:--:|:--:|:--:|:--:|
| <img width="200" alt="copper-drone" src="https://github.com/user-attachments/assets/31096307-fe1b-4315-b876-0f7237d69fa4" /> | <img width="200" alt="copper-driving" src="https://github.com/user-attachments/assets/1f051359-1ff4-45c6-838b-44442dc06ac4" /> | <img width="200" alt="copper-swimming" src="https://github.com/user-attachments/assets/5a0d0279-da98-4d4d-b5e1-e0cd8890a368" /> | <img width="200" alt="copper-space" src="https://github.com/user-attachments/assets/c535413e-014f-4846-ab06-a49e1151e42e" /> |
### You don't have a real robot yet? Try it in our minimalistic sim environment!
[](https://youtu.be/kC6sGRZUxLE)
Here is a Copper-based robot in action in a Bevy simulation environment!
The realistic sim is created using [Bevy](https://crates.io/crates/bevy) (A Rust Game Engine)
and [Avian3d](https://crates.io/crates/avian3d) (Physics Engine in Rust).
On your mac or linux machine (x86-64 or Arm) just run ...
```bash
$ cargo install cu-rp-balancebot
$ balancebot-sim
```
... to try it locally.
The source code for this demo is available in the [examples/cu_rp_balancebot](examples/cu_rp_balancebot) directory.
## Get Started
- Start a new project from templates: [Project Templates](https://copper-project.github.io/copper-rs/Project-Templates)
- See a full task graph + runtime walkthrough: [Copper Application Overview](https://copper-project.github.io/copper-rs/Copper-Application-Overview)
- Build and deploy an application: [Build and Deploy a Copper Application](https://copper-project.github.io/copper-rs/Build-and-Deploy-a-Copper-Application)
- RON configuration reference: [Copper RON Configuration Reference](https://copper-project.github.io/copper-rs/Copper-RON-Configuration-Reference)
## Documentation
[Link to the full documentation](https://copper-project.github.io/copper-rs/)
- Runtime concepts and SDK features: [Copper Runtime Overview](https://copper-project.github.io/copper-rs/Copper-Runtime-Overview)
- Task lifecycle: [Task Lifecycle](https://copper-project.github.io/copper-rs/Task-Lifecycle)
- Modular configuration: [Modular Configuration](https://copper-project.github.io/copper-rs/Modular-Configuration)
- Task automation: [Task Automation with just](https://copper-project.github.io/copper-rs/Task-Automation-with-Just)
- Supported platforms: [Supported Platforms](https://copper-project.github.io/copper-rs/Supported-Platforms)
- Bare-metal development: [Baremetal Development](https://copper-project.github.io/copper-rs/Baremetal-Development)
- Available components: [Available Components](https://copper-project.github.io/copper-rs/Available-Components)
- FAQ: [FAQ](https://copper-project.github.io/copper-rs/FAQ)
- Release notes: [Copper Release Notes](https://copper-project.github.io/copper-rs/Copper-Release-Notes)
- Roadmap: [Roadmap](https://copper-project.github.io/copper-rs/Roadmap)
## Project
> [!NOTE]
> We are looking for contributors to help us build the best robotics framework possible. If you are interested, please
> join us on [Discord](https://discord.gg/VkCG7Sb9Kw) or open an issue.