Skip to content

State a supported minimum Python version - #2491

Merged
3b1b merged 2 commits into
3b1b:masterfrom
00PrabalK00:docs/python-version
Aug 10, 2026
Merged

3b1b merged 2 commits into
3b1b:masterfrom
00PrabalK00:docs/python-version

Conversation

@00PrabalK00

@00PrabalK00 00PrabalK00 commented Aug 10, 2026 •

Copy link
Copy Markdown
Contributor

Motivation

The README and the installation docs say Python 3.7 or higher, and the conda instructions create a 3.8 environment. Neither can work. ipython>=8.18.0 alone rules out anything below 3.9, and on 3.9 importing manimlib fails outright.

To be precise about why 3.10 rather than 3.9, since it comes down to very little: compileall under 3.9 passes on all of manimlib, so there is no 3.10 only syntax. The import failure is Mobject.stash_mobject_pointers and Scene.affects_mobject_list, @staticmethod functions used as decorators inside their own class body, legal to call directly only from 3.10. That is #2263, which #2466 targets. Drop those two @staticmethod lines locally and 3.9 imports and renders fine.

So the case for 3.10 is not that the library needs it deeply, it is that 3.9 went end of life in October 2025 and current releases of rendercanvas, skia-pathops, pillow and trimesh all require 3.10 or higher. On 3.9 pip resolves back to wgpu 0.24 and rendercanvas 2.2.1 to stay under that ceiling. Happy to cut this back to a docs only change and drop the python_requires if you would rather keep 3.9 installable.

Fixes #2405

Proposed changes

  • Say Python 3.10 in the README and in installation.rst, and create the conda env with 3.10
  • Add python_requires = >=3.10 to setup.cfg, so pip reports the problem before installing rather than after
  • Update the classifiers to match

Test

Code:

uv venv /tmp/v39 --python 3.9   # and 3.10, 3.11, 3.12
uv pip install --python /tmp/v39 -e .
/tmp/v39/bin/python -c "import manimlib"

Result:

3.9 fails with TypeError: 'staticmethod' object is not callable. 3.10, 3.11 and 3.12 all install and import fine.

The README and the installation docs say Python 3.7 or higher, and the conda
instructions create a 3.8 environment. Neither can work: `ipython>=8.18.0`
alone rules out anything below 3.9, and on 3.9 importing manimlib raises
"TypeError: 'staticmethod' object is not callable", since calling a
staticmethod object directly, as Mobject and Scene do with their decorators,
only became legal in 3.10.

3.9 reached end of life in October 2025, and current releases of rendercanvas,
skia-pathops, pillow and trimesh all require 3.10 or higher, so 3.10 is where
the dependency stack sits regardless. Say so in both places, and add a
python_requires so pip reports the problem up front rather than after a failed
install. Classifiers follow.

Fixes 3b1b#2405
@00PrabalK00 00PrabalK00 changed the title State the real minimum Python version State a supported minimum Python version Aug 10, 2026
@3b1b
3b1b merged commit 4df6c34 into 3b1b:master Aug 10, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Installation guide suggests Python 3.8, but fails due to ipython>=8.18.0 requiring Python ≥3.9

2 participants