fluxopt

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

Category: Energy Systems
Sub Category: Energy System Modeling Frameworks

Last synced: about 23 hours ago
JSON representation

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 (3 months ago)
• Default Branch: main
• Last Pushed: 2026-05-18T07:56:16.000Z (8 days ago)
• Last Synced: 2026-05-21T11:29:23.713Z (5 days ago)
• Language: Python
• Homepage: https://fbumann.github.io/fluxopt/
• Size: 3.15 MB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 27
• Releases: 6
• 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     (examples)
    plotting      YAML+CSV      time series     cross-package
   (plotly)       loader       aggregation       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: 15
• Pull request event: 42
• Issues event: 55
• Issue comment event: 33
• Push event: 153
• Pull request review comment event: 32
• Pull request review event: 18
• Create event: 45

Last Year

• Delete event: 15
• Pull request event: 42
• Issues event: 55
• Issue comment event: 33
• Push event: 153
• Pull request review comment event: 32
• Pull request review event: 18
• Create event: 45

Committers metadata

Last synced: 3 days ago

Committer domains:

• gitbutler.com: 1

Issue and Pull Request metadata

Last synced: 3 days ago

Package metadata

• Total packages: 1
• Total downloads:
  • pypi: 70 last-month
• Total dependent packages: 0
• Total dependent repositories: 0
• Total versions: 2
• Total maintainers: 1

Dependencies

Score: 9.01627006814768