# pybamm-team/PyBaMM

Fast and flexible physics-based battery models in Python

Repository: https://github.com/pybamm-team/PyBaMM
Canonical: https://ross.abutalabs.com/products/pybamm
Homepage: https://www.pybamm.org/
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: pybamm, battery-models, solvers, python, batteries, simulation, hacktoberfest
Last push: 2026-08-25T20:00:37+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 2863, "days_push": 8, "days_rel": 15, "gap_med": 9, "n_releases_24m": 34}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1648, forks 792 (observed 2026-08-28T04:05:16.614736+00:00)

## What it is
PyBaMM (Python Battery Mathematical Modelling) is an open-source Python package for fast, flexible physics-based battery simulation. It provides a framework for defining and solving systems of differential equations, a library of battery models and parameters, and tools for simulating battery experiments and visualizing results.

## Use cases
- simulate lithium-ion battery discharge curves
- model battery degradation and aging
- compare battery models like SPM, DFN, and Doyle-Fuller-Newman
- run constant-current charge/discharge experiments in Python
- explore effect of battery design parameters on performance
- fit battery parameters to experimental data
- integrate battery simulation with Python data science and ML workflows

## When to choose
- you need physics-based battery models rather than equivalent-circuit approximations
- you want to prototype and compare multiple electrochemical models quickly in Python
- you are doing battery R&D research and need open-source, extensible simulation tools
- you need fast solvers for battery-specific experiments with visualization built in

## When to avoid
- you only need simple equivalent-circuit battery models for circuit simulation
- you need real-time battery management system deployment rather than offline simulation
- you work outside Python and cannot use a Python-based toolchain
- you need commercial support and turnkey GUI-based battery simulation software

## Facets
- artifact type: library
- maturity: active
- function: simulation, math, data-visualization
- domain: simulation, energy, data-science
- platform: python, cross-platform
- tags: battery-models, electrochemistry, differential-equations, physics-based-modeling, batteries, scientific-computing, solver, research

## Member repositories
- pybamm-team/PyBaMM (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:16.614736+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:45:13.652595+00:00, confidence not recorded.
  - readme: https://github.com/pybamm-team/PyBaMM (fetched 2026-08-28T04:05:16.614736+00:00, sha cd18329e8185)
  - homepage: https://www.pybamm.org/ (fetched 2026-08-29T11:19:41.810414+00:00, sha 6adac9cade7d)
  - site_page: https://pybamm.org/about (fetched 2026-08-29T11:19:41.823200+00:00, sha 9c22dac53e2e)
  - site_page: https://pybamm.org/changelog (fetched 2026-08-29T11:19:41.825250+00:00, sha 4444f8b03f58)
- Data as of 2026-08-30T08:39:29.467469+00:00.