fluxopt

Energy system optimization with linopy — detailed dispatch, scaled to multi period planning.
https://github.com/fbumann/fluxopt

Last synced: 4 days ago
JSON representation

Acceptance Criteria

• Revelant topics? false
• External users? true
• Open source license? true
• Active? true
• Fork? false

Repository metadata

Successor of flixopt with a new datamodel

• Host: GitHub
• URL: https://github.com/fbumann/fluxopt
• Owner: FBumann
• License: mit
• Created: 2026-02-12T22:54:29.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-06-05T23:43:52.000Z (11 days ago)
• Last Synced: 2026-06-07T02:02:56.860Z (10 days ago)
• Language: Python
• Homepage: https://fluxopt.readthedocs.io/
• Size: 3.16 MB
• Stars: 2
• Watchers: 0
• Forks: 1
• Open Issues: 36
• Releases: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE

README.md

pip install fluxopt

# A gas boiler covers a heat demand, minimizing fuel cost
from datetime import datetime
from fluxopt import Carrier, Converter, Effect, Flow, Port, optimize

result = optimize(
    timesteps=[datetime(2024, 1, 1, h) for h in range(4)],
    carriers=[Carrier('gas'), Carrier('heat')],
    effects=[Effect('cost')],
    ports=[
        Port('grid', imports=[
            Flow('gas', size=500, effects_per_flow_hour={'cost': 0.04})
        ]),
        Port('demand', exports=[
            Flow('heat', size=100, fixed_relative_profile=[0.4, 0.7, 0.5, 0.6])
        ])
    ],
    converters=[
        Converter.boiler(
            'boiler',
            thermal_efficiency=0.9,
            fuel_flow=Flow('gas', size=300),
            thermal_flow=Flow('heat', size=200)
        )
    ],
    objective_effects='cost',
)

print(f"Total cost: {result.objective:.2f}")
print(result.flow_rates)

                          ┌──────────────┐
                          │   fluxopt    │  core: model building, solving, results, IO
                          └──────┬───────┘
        ┌──────────────┬─────────┼──────────────┬──────────────┐
        │              │         │              │              │
 fluxopt-plot   fluxopt-yaml  fluxopt-tsam  fluxopt-marimo  (examples)
   plotting      YAML+CSV    time series    interactive     cross-package
   (plotly)       loader     aggregation       apps          notebooks

uv sync --group dev      # Install deps
uv run pytest -v         # Run tests
uv run ruff check .      # Lint
uv run ruff format .     # Format

Owner metadata

• Name:
• Login: FBumann
• Email:
• Kind: user
• Description:
• Website:
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/117816358?v=4
• Repositories: 1
• Last ynced at: 2023-12-19T18:01:32.842Z
• Profile URL: https://github.com/FBumann

GitHub Events

Total

• Delete event: 16
• Pull request event: 45
• Issues event: 55
• Issue comment event: 33
• Push event: 157
• Pull request review comment event: 32
• Pull request review event: 18
• Create event: 46

Last Year

• Delete event: 16
• Pull request event: 45
• Issues event: 55
• Issue comment event: 33
• Push event: 157
• Pull request review comment event: 32
• Pull request review event: 18
• Create event: 46

Committers metadata

Last synced: 4 days ago

Committer domains:

• gitbutler.com: 1

Issue and Pull Request metadata

Last synced: 4 days ago

Package metadata

• Total packages: 1
• Total downloads:
  • pypi: 383 last-month
• Total dependent packages: 0
• Total dependent repositories: 0
• Total versions: 3
• Total maintainers: 1

Dependencies

Score: 10.974523073434003