{"id":13724081,"url":"https://github.com/dos-group/vessim","last_synced_at":"2026-05-04T01:02:35.147Z","repository":{"id":176865683,"uuid":"603417933","full_name":"dos-group/vessim","owner":"dos-group","description":"A co-simulation testbed for computing and energy systems 🍃","archived":false,"fork":false,"pushed_at":"2026-04-13T12:26:16.000Z","size":56732,"stargazers_count":83,"open_issues_count":1,"forks_count":12,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-04-28T10:08:37.105Z","etag":null,"topics":["carbon-aware","co-simulation","energy-system","simulation","software-in-the-loop","testbed"],"latest_commit_sha":null,"homepage":"https://vessim.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dos-group.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-18T12:59:09.000Z","updated_at":"2026-04-13T15:32:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"f00e242d-a02c-4577-b290-01938007c565","html_url":"https://github.com/dos-group/vessim","commit_stats":{"total_commits":839,"total_committers":11,"mean_commits":76.27272727272727,"dds":0.7616209773539928,"last_synced_commit":"7be55b5e21ed195292e2831158f6f13a92021086"},"previous_names":["dos-group/vessim"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/dos-group/vessim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dos-group%2Fvessim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dos-group%2Fvessim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dos-group%2Fvessim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dos-group%2Fvessim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dos-group","download_url":"https://codeload.github.com/dos-group/vessim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dos-group%2Fvessim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32590466,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"ssl_error","status_checked_at":"2026-05-03T22:09:10.534Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["carbon-aware","co-simulation","energy-system","simulation","software-in-the-loop","testbed"],"created_at":"2024-08-03T01:01:49.796Z","updated_at":"2026-05-04T01:02:35.130Z","avatar_url":"https://github.com/dos-group.png","language":"Python","funding_links":[],"categories":["Dev / Tooling","Uncategorized","Energy Systems"],"sub_categories":["General purpose","Uncategorized","Grid Management and Microgrid"],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"Vessim Logo\" src=\"docs/assets/logo.png\" width=\"250\" /\u003e\n\u003c/p\u003e\n\nVessim is a **co-simulation testbed for computing and energy systems**.\n\nVessim lets you simulate the interaction of real or simulated computing systems with on-site energy sources, storage, and the public grid.\nIt connects domain-specific simulators for power generation and batteries with **real software and hardware**.\n\nCheck out the [website and documentation](https://vessim.readthedocs.io/en/latest/)!\n\n## What can I do with Vessim?\n\nVessim helps you to understand and optimize how your (distributed) computing system interacts with (distributed) energy sources and battery storage.\n\n- **Energy-aware and carbon-aware applications**: Develop applications that adapt their energy consumption to the carbon intensity and price of electricity.\n- **Microgrid composition**: Experiment with adding solar panels, wind turbines, or batteries to see how they would affect your energy costs and carbon emissions.\n- **Demand response and power outages**: Simulate demand response signals or power outages to understand your system's flexibility and test mitigation strategies.\n\nVessim can simulate multiple distributed microgrids in parallel and easily integrates historical datasets and new simulators. \nVessim’s software-in-the-loop capabilities let you run real systems against simulated microgrids. Connect live data sources like Prometheus and interact through REST APIs.\n\n\n## Simple Example\n\nThe scenario below simulates a microgrid with a computing system drawing 700W, a solar panel, and a 1.5 kWh battery.\n\n```python\nimport vessim as vs\n\nenvironment = vs.Environment(sim_start=\"2022-06-09\", step_size=300)\n\nenvironment.add_microgrid(\n    name=\"datacenter\",\n    actors=[\n        vs.Actor(name=\"server\", signal=vs.StaticSignal(value=700), consumer=True),\n        vs.Actor(name=\"solar_panel\", signal=vs.Trace.from_csv(\n            \"datasets/solar_example.csv\", column=\"Berlin\", scale=5000\n        )),\n    ],\n    dispatchables=[\n        vs.SimpleBattery(name=\"battery\", capacity=1500, initial_soc=0.8, min_soc=0.3)\n    ],\n)\n\nenvironment.add_controller(vs.CsvLogger(\"results/my_experiment\"))\nenvironment.run(until=24 * 3600)\n```\n\nCheck out the [Getting Started walkthrough](https://vessim.readthedocs.io/en/latest/getting_started/) and [`examples/`](examples/) for more, including multi-microgrid setups and software-in-the-loop simulations.\n\n\n## Installation\n\nYou can install the [latest release](https://pypi.org/project/vessim/) of Vessim\nvia [pip](https://pip.pypa.io/en/stable/quickstart/):\n\n```\npip install vessim\n```\n\nIf you require software-in-the-loop capabilities, install the `sil` extension:\n\n```\npip install vessim[sil]\n```\n\n## Publications\n\nIf you use Vessim in your research, please cite our paper:\n\n- Philipp Wiesner, Ilja Behnke, Paul Kilian, Marvin Steinke, and Odej Kao. \"[Vessim: A Testbed for Carbon-Aware Applications and Systems.](https://dl.acm.org/doi/pdf/10.1145/3727200.3727210)\" _ACM SIGENERGY Energy Informatics Review 4 (5)_. 2024.\n\nFor details in Vessim's software-in-the-loop simulation methodology, refer to:\n\n- Philipp Wiesner, Marvin Steinke, Henrik Nickel, Yazan Kitana, and Odej Kao. \"[Software-in-the-Loop Simulation for Developing and Testing Carbon-Aware Applications.](https://doi.org/10.1002/spe.3275)\" _Software: Practice and Experience, 53 (12)_. 2023.\n\nFor more related papers and concrete use cases, please refer to the [documentation](https://vessim.readthedocs.io/en/latest/publications).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdos-group%2Fvessim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdos-group%2Fvessim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdos-group%2Fvessim/lists"}