cobre
Python bindings for the Cobre power systems solver.
Cobre is a high-performance SDDP (Stochastic Dual Dynamic Programming) solver for hydrothermal dispatch, written in Rust. This package provides Python access to case loading, validation, training, simulation, and result inspection.
Installation
pip install cobre-python
Pre-built wheels are available for:
- Linux x86_64 (manylinux_2_34)
- Linux aarch64 (manylinux_2_28)
- Linux musl x86_64 (musllinux_1_2)
- macOS Apple Silicon (aarch64) and Intel (x86_64)
- Windows x86_64
- Python 3.12+
Quick Start
import cobre
# Load and validate a case
system = cobre.io.load_case("path/to/case")
print(f"System: {system.n_buses} buses, {system.n_hydros} hydros, {system.n_thermals} thermals")
# Run training + simulation
result = cobre.run.run("path/to/case", output_dir="output/")
print(f"Converged: {result['converged']}, LB: {result['lower_bound']:.2f}")
convergence = cobre.results.load_convergence("output/")
print(f"Iterations: {len(convergence)}")
simulation = cobre.results.load_simulation("output/")
print(f"Cost records: {len(simulation['costs'])}")
policy = cobre.results.load_policy("output/")
print(f"Iterations completed: {policy['metadata']['producer']['completed_iterations']}")
The same workflow, driven step by step:
# The Study lifecycle — construct, train, simulate
study = cobre.Study("path/to/case", output_dir="output/")
policy = study.train()
summary = study.simulate(policy)
print(f"Scenarios: {summary['n_scenarios']}, Completed: {summary['completed']}")
# Inspect the study before running any phase
print(f"Stages: {study.stochastic['n_stages']}, Seed: {study.stochastic['seed']}")
Modules
cobre.io— Load and validate case directoriescobre.model— Data model classes (System, Bus, Line, Thermal, Hydro, etc.)cobre.run— Execute SDDP training and simulationcobre.results— Load and inspect output artifacts, including convergence history, Parquet simulation outputs, and FlatBuffers policy (FCF) checkpointscobre.schema— JSON Schema export for case-directory input typescobre.errors— Typed exception hierarchy for case-loading and solver errors
The package also exports Study, Policy, write_policy_checkpoint, and version_info at the top level.
Requirements
- Python >= 3.12
- No runtime dependencies (the Rust solver is statically linked)
License
Apache-2.0 — see LICENSE.
Links
1 maintainer
Metadata
1 maintainer
Release files for cobre-python 0.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| cobre_python-0.17.0-cp312-abi3-win_amd64.whl | CPython 3.12 | abi3 | Windows x86-64 | Details |
| cobre_python-0.17.0-cp312-abi3-musllinux_1_2_x86_64.whl | CPython 3.12 | abi3 | Linux musl 1.2+ x86-64 | Details |
| cobre_python-0.17.0-cp312-abi3-manylinux_2_34_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.34+ x86-64 | Details |
| cobre_python-0.17.0-cp312-abi3-manylinux_2_28_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| cobre_python-0.17.0-cp312-abi3-macosx_11_0_arm64.whl | CPython 3.12 | abi3 | macOS 11.0+ ARM64 | Details |
| cobre_python-0.17.0-cp312-abi3-macosx_10_12_x86_64.whl | CPython 3.12 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 59.4 MB
Release files / cobre_python-0.17.0-cp312-abi3-win_amd64.whl
| Download URL | cobre_python-0.17.0-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 7.9 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
f2f154a36a23ed1117463b009cd720b42cb18d000b33ce8d1c5b3574f5ca1059
|
|
BLAKE2b-256 checksum How to use checksums |
819b8157d2ebbdd74cd616cd3422530dcc84f25f5a1a57928f08e635548a0758
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency logRelease files / cobre_python-0.17.0-cp312-abi3-musllinux_1_2_x86_64.whl
| Download URL | cobre_python-0.17.0-cp312-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 15.9 MB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
c565a25424d48a7ae9608119c64810f5e1450e0bea94b3fcb27f3403ad4a9a17
|
|
BLAKE2b-256 checksum How to use checksums |
593db3716fb8d7e020d363585b7a3a40fcfd6825cfa3155d1a8932aae1d870b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency logRelease files / cobre_python-0.17.0-cp312-abi3-manylinux_2_34_x86_64.whl
| Download URL | cobre_python-0.17.0-cp312-abi3-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 9.6 MB |
| Tags | CPython 3.12 Linux glibc 2.34+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
c0b117d212ce0895ff64e5b122e58ecb37d408f381b4d4707daf0f2beefc25fc
|
|
BLAKE2b-256 checksum How to use checksums |
e8670c6878e48ad80f0a917be72641a7c020c00bf3225072a7172091c05dbabf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency logRelease files / cobre_python-0.17.0-cp312-abi3-manylinux_2_28_aarch64.whl
| Download URL | cobre_python-0.17.0-cp312-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 9.0 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
b67bd90ed9ce5e36ea67b93245bfe65c08890c72517dbe8af957857fb97ac81d
|
|
BLAKE2b-256 checksum How to use checksums |
119c21f374b18e66c48519694e779d072f4f081c49327fbe959ebeb73326bcad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency logRelease files / cobre_python-0.17.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | cobre_python-0.17.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 8.1 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
1986a3eddb9773ca49ae1d5f67441a41db1608ee9e1266a01d8731b8632a2d50
|
|
BLAKE2b-256 checksum How to use checksums |
f66b9e0068af844fe77744337ef7ef3e612c7a6822ebce4e64c92ae8dfcc52de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency logRelease files / cobre_python-0.17.0-cp312-abi3-macosx_10_12_x86_64.whl
| Download URL | cobre_python-0.17.0-cp312-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 8.9 MB |
| Tags | CPython 3.12 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
4762b2c83564437eca39e6079207b52f81af02df28ca78370bedbc630ec9bdf8
|
|
BLAKE2b-256 checksum How to use checksums |
ead54231d3e485793e1f8e7f338b14d7800a665635429d67328b9b4d30d6bd9c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency log
