Cobre

---

Cobre is a Rust ecosystem for power system optimization. It ships a distributed SDDP solver for hydrothermal dispatch with a CLI and Python bindings. The name comes from the Portuguese word for copper.

Why Cobre?

• Production performance -- Rust gives C/C++-level speed with memory safety. For software that dispatches national power grids, both matter.
• Reproducibility -- Declaration-order invariance guarantees bit-for-bit identical results regardless of input entity ordering.
• Modularity -- Pick the crates you need. Use cobre-core for data modeling alone, or cobre-sddp for the full solver.
• Interoperability -- JSON/Parquet input, Python bindings for Jupyter workflows, MCP server for AI agents (reserved; not yet implemented).

Install

# Rust CLI (requires Rust 1.88+ and HiGHS)
cargo install cobre-cli

# Python bindings (3.12 / 3.13 / 3.14)
pip install cobre-python

Quick Links

Resource	Link
Documentation	docs.cobre-rs.dev
API Docs	docs.rs/cobre-sddp
PyPI	pypi.org/project/cobre-python

Getting Started

• Coming from other software? -- See the cobre-bridge guide
• New to SDDP? -- Read What Cobre Solves
• Python user? -- Try the Python Quickstart

Current Status

Cobre is alpha software with a fully functional SDDP solver. The pipeline covers case loading, stochastic scenario generation, training, simulation, policy checkpointing, and output writing. See the CHANGELOG for release history.

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines.

License

Licensed under Apache-2.0.

@software{cobre,
  author = {Alves, Rogerio J. M.},
  title = {Cobre: Open Infrastructure for Power System Computation},
  url = {https://github.com/cobre-rs/cobre},
  license = {Apache-2.0}
}