# \`aiida-quantumespresso\`: (planned) breaking changes for v5.0 **URL:** \ **Category:** Developer\ **Created:** [October 7, 2025, 1:18am UTC](https://aiida.discourse.group/t/aiida-quantumespresso-planned-breaking-changes-for-v5-0/684 "2025-10-07T01:18:57Z")\ **Posts on this page:** 4\ **Page:** 1
**Author:** ![mbercx](https://yyz2.discourse-cdn.com/free1/user_avatar/aiida.discourse.group/mbercx/32/345_2.png) [@mbercx](https://aiida.discourse.group/u/mbercx)\ **Post date:** [October 7, 2025, 1:18am UTC](https://aiida.discourse.group/t/aiida-quantumespresso-planned-breaking-changes-for-v5-0/684/1 "2025-10-07T01:18:57Z")
Hi fellow `aiida-quantumespresso` developers! A month ago, I released an alpha release of `aiida-quantumespresso` ([`5.0.0a1`](https://pypi.org/project/aiida-quantumespresso/5.0.0a1/)). This was done in a bit of a hurry, since we needed some breaking changes released for the [MC3D paper](https://arxiv.org/abs/2508.19223) submission. The two breaking changes in `5.0.0a1` are: - [`PwRelaxWorkChain` : Revisit work chain logic](https://github.com/aiidateam/aiida-quantumespresso/commit/830aef35445e8c6d596e54651c9a891ce6b4b77e) - [Remove all code related to XSpectra & XPS](https://github.com/aiidateam/aiida-quantumespresso/commit/1e3ea1e1ea67dff5d781e86a1afea41e4ec7ac3d) Since then, I’ve made one more breaking change on `main`: - [Remove EPW-related content](https://github.com/aiidateam/aiida-quantumespresso/commit/63fee4db01cc25ad7ecaec0b958ee661d2ec3de6) First of all: apologies for any other developers of the `aiida-quantumespresso` if you had issues on `main`. Ideally we would have waited with the breaking changes, but the `5.0.0a1` needed to be on PyPI for the paper. The other two should not have affected anyone’s work. Most other changes have been backwards-compatible, and added to a v4.X support branch, where we since released [v4.14.0](https://github.com/aiidateam/aiida-quantumespresso/blob/support/v4.x/CHANGELOG.md#v4140) and [v4.15.0](https://github.com/aiidateam/aiida-quantumespresso/blob/support/v4.x/CHANGELOG.md#v4150). To avoid having to maintain a `main` and support branch for two long, I am trying to push for a stable v5.0.0 release. However, there are still a few breaking changes I am keen to make. You can find these issues on the [v5.0.0 milestone](https://github.com/aiidateam/aiida-quantumespresso/issues?q=is%3Aissue%20state%3Aopen%20milestone%3Av5.0.0). I wanted to give everyone a heads up, and the opportunity to comment on these breaking changes. I’ll be working on adding deprecation paths where possible to the v4.X support branch. Once v5.0.0 is out and stable, the v4.X support branch will only be maintained for critical bug fixes. EDIT: I forgot to give a time line: My plan is to 1. give other developers 10 days to comment (deadline 17 October 2025). 2. add deprecations for chosen breaking changes to v4.16.0 the week after (24 Oct) 3. get to a stable v5.0.0 release in ~1 month (7 Nov) 4. (try to) keep the v4.X support branch fully supported until 31 Nov, then only critical bug fixes. Bug fix support for v4.X will only be dropped when we start pushing for [v6.0.0](https://github.com/aiidateam/aiida-quantumespresso/issues?q=is%3Aissue%20state%3Aopen%20milestone%3Av6.0.0). ---
**Author:** ![giovannipizzi](https://yyz2.discourse-cdn.com/free1/user_avatar/aiida.discourse.group/giovannipizzi/32/17_2.png) [@giovannipizzi](https://aiida.discourse.group/u/giovannipizzi)\ **Post date:** [October 8, 2025, 1:39pm UTC](https://aiida.discourse.group/t/aiida-quantumespresso-planned-breaking-changes-for-v5-0/684/2 "2025-10-08T13:39:12Z")
Thanks Marnik! Would it be possible to consider also [Keep restarting (even more than 5 times) if just out of walltime · Issue #559 · aiidateam/aiida-quantumespresso · GitHub](https://github.com/aiidateam/aiida-quantumespresso/issues/559) for 5.0? It requires a bit of discussion but I think it’s important, we’ve been hitting this issue many times. Also @mikibonacci can comment on his experience (as well as the monitor scripts he’s been working on - if we decide to keep them in the main branch, now it could be a good moment to merge them? ---
**Author:** ![mbercx](https://yyz2.discourse-cdn.com/free1/user_avatar/aiida.discourse.group/mbercx/32/345_2.png) [@mbercx](https://aiida.discourse.group/u/mbercx)\ **Post date:** [October 8, 2025, 6:42pm UTC](https://aiida.discourse.group/t/aiida-quantumespresso-planned-breaking-changes-for-v5-0/684/3 "2025-10-08T18:42:20Z")
Thanks Gio! I’ve already removed several other things from v5.0.0 because I want to limit the scope and avoid having to maintain two branches for too long. Besides, are these breaking changes? I suppose it depends on how we implement #559 (which won’t be that trivial to be honest). @giovannipizzi @mikibonacci let’s discuss on the issues. But I would try to avoid quickly pushing things into v5.0.0. ---
**Author:** ![mbercx](https://yyz2.discourse-cdn.com/free1/user_avatar/aiida.discourse.group/mbercx/32/345_2.png) [@mbercx](https://aiida.discourse.group/u/mbercx)\ **Post date:** [May 13, 2026, 11:16am UTC](https://aiida.discourse.group/t/aiida-quantumespresso-planned-breaking-changes-for-v5-0/684/4 "2026-05-13T11:16:27Z")
In complete agreement with the original timeline (_cough_), we’ve now [released v5.0.0](https://pypi.org/project/aiida-quantumespresso/5.0.0/)! 🥳 You can find the migration guide here: > **[v5.0.0 - Migration — aiida-quantumespresso documentation](https://aiida-quantumespresso.readthedocs.io/en/stable/reference/migration.html#v5-0-0)** > > The PwRelaxWorkChain has been significantly reworked. The key changes are: Let’s _hope_ we didn’t break anything else, please open an issue if you encounter any trouble!