EthicalSmartGrid

Spec sheet

Purpose

EthicalSmartGrid is a simplified multi-agent smart-grid simulator for learning ethical behaviours.Read 11 Oct 2026 · ethicsai.github.io

Free plan

YesRead 24 Sep 2026 · github.com

Privacy

The use-case separates shared global observations from individual local observations, which other agents cannot access.Read 11 Oct 2026 · ethicsai.github.io

Support

The project README directs questions to GitHub Discussions and bug reports to the issue tracker.Read 11 Oct 2026 · github.com

License

The repository says the source code is licensed under the MIT License and notes that some included data may have other licenses.Read 11 Oct 2026 · github.com

3D visuals

NoRead 24 Sep 2026 · github.com

Agents

Agents represent buildings or parts of buildings, including households, offices, and schools, and act as proxies for their inhabitants.Read 11 Oct 2026 · ethicsai.github.io

Assessment tools

NoRead 24 Sep 2026 · github.com

Authoring tools

YesRead 24 Sep 2026 · github.com

Custom rewards

Users can define custom argumentation-based reward functions with the AJAR library.Read 11 Oct 2026 · ethicsai.github.io

Customization

Users can configure scenarios and extend the environment with their own components.Read 11 Oct 2026 · ethicsai.github.io

Energy model

Agents can consume and store energy from a shared local source, use personal storage, and buy from or sell energy to the national grid.Read 11 Oct 2026 · ethicsai.github.io

Ethical values

The environment models security of supply, affordability, inclusiveness, and environmental sustainability.Read 11 Oct 2026 · ethicsai.github.io

Framework

It provides a Gymnasium environment for multi-agent reinforcement learning and aims to follow the Gymnasium API closely.Read 11 Oct 2026 · ethicsai.github.io

Framework compatibility

The documented usage provides a PettingZoo environment designed to work with PettingZoo-compliant learning algorithms with little or no modification.Read 11 Oct 2026 · ethicsai.github.io

Installation

The package can be installed from PyPI with `pip install ethical-smart-grid` or cloned from GitHub.Read 11 Oct 2026 · ethicsai.github.io

Lesson library

NoRead 24 Sep 2026 · github.com

Model limitation

The project documentation says its simulated smart grid is simplified and is not developed as a realistic simulator.Read 11 Oct 2026 · ethicsai.github.io

Observations

Observations are split into shared global values and agent-specific local values, including personal storage, comfort, and payoff.Read 11 Oct 2026 · ethicsai.github.io

Optional dependency

Using the argumentation reward package requires the AJAR library; importing that package without AJAR raises an error.Read 11 Oct 2026 · ethicsai.github.io

Reward functions

The package includes numeric reward functions, and from version 1.2.0 it also supports argumentation-based reward functions.Read 11 Oct 2026 · ethicsai.github.io

Rewards

It provides numeric reward functions and, from v1.2.0, optional argumentation-based reward functions.Read 11 Oct 2026 · ethicsai.github.io

Simulation limitation

The documentation says the simulated grid is simplified and is not developed as a realistic simulator.Read 11 Oct 2026 · ethicsai.github.io

Use case

The simulated grid includes prosumer agents that produce and consume energy, a shared local energy source, and a connection to the national grid.Read 11 Oct 2026 · ethicsai.github.io

Where Specifiction places it

• Physics Simulation Software#83 of 896.9