manim

A community-maintained Python framework for creating mathematical animations.

https://github.com/manimcommunity/manim

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    13 of 454 committers (2.9%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.4%) to scientific vocabulary

Keywords

animations hacktoberfest manim math python

Keywords from Contributors

jax closember cryptocurrency transformers formatter codeformatter gtk qt tk autopep8
Last synced: 4 months ago · JSON representation ·

Repository

A community-maintained Python framework for creating mathematical animations.

Basic Info
  • Host: GitHub
  • Owner: ManimCommunity
  • License: mit
  • Language: Python
  • Default Branch: main
  • Homepage: https://www.manim.community
  • Size: 42.7 MB
Statistics
  • Stars: 34,468
  • Watchers: 188
  • Forks: 2,417
  • Open Issues: 459
  • Releases: 29
Topics
animations hacktoberfest manim math python
Created over 5 years ago · Last pushed 4 months ago
Metadata Files
Readme Contributing License Code of conduct Citation

README.md



PyPI Latest Release Docker image MIT License Reddit Twitter Discord Code style: black Documentation Status Downloads CI

An animation engine for explanatory math videos


Manim is an animation engine for explanatory math videos. It's used to create precise animations programmatically, as demonstrated in the videos of 3Blue1Brown.

[!NOTE] The community edition of Manim (ManimCE) is a version maintained and developed by the community. It was forked from 3b1b/manim, a tool originally created and open-sourced by Grant Sanderson, also creator of the 3Blue1Brown educational math videos. While Grant Sanderson continues to maintain his own repository, we recommend this version for its continued development, improved features, enhanced documentation, and more active community-driven maintenance. If you would like to study how Grant makes his videos, head over to his repository (3b1b/manim).

Table of Contents:

Installation

[!CAUTION] These instructions are for the community version only. Trying to use these instructions to install 3b1b/manim or instructions there to install this version will cause problems. Read this and decide which version you wish to install, then only follow the instructions for your desired version.

Manim requires a few dependencies that must be installed prior to using it. If you want to try it out first before installing it locally, you can do so in our online Jupyter environment.

For local installation, please visit the Documentation and follow the appropriate instructions for your operating system.

Usage

Manim is an extremely versatile package. The following is an example Scene you can construct:

```python from manim import *

class SquareToCircle(Scene): def construct(self): circle = Circle() square = Square() square.flip(RIGHT) square.rotate(-3 * TAU / 8) circle.set_fill(PINK, opacity=0.5)

    self.play(Create(square))
    self.play(Transform(square, circle))
    self.play(FadeOut(square))

```

In order to view the output of this scene, save the code in a file called example.py. Then, run the following in a terminal window:

sh manim -p -ql example.py SquareToCircle

You should see your native video player program pop up and play a simple scene in which a square is transformed into a circle. You may find some more simple examples within this GitHub repository. You can also visit the official gallery for more advanced examples.

Manim also ships with a %%manim IPython magic which allows to use it conveniently in JupyterLab (as well as classic Jupyter) notebooks. See the corresponding documentation for some guidance and try it out online.

Command line arguments

The general usage of Manim is as follows:

manim-illustration

The -p flag in the command above is for previewing, meaning the video file will automatically open when it is done rendering. The -ql flag is for a faster rendering at a lower quality.

Some other useful flags include:

  • -s to skip to the end and just show the final frame.
  • -n <number> to skip ahead to the n'th animation of a scene.
  • -f show the file in the file browser.

For a thorough list of command line arguments, visit the documentation.

Documentation

Documentation is in progress at ReadTheDocs.

Docker

The community also maintains a docker image (manimcommunity/manim), which can be found on DockerHub. Instructions on how to install and use it can be found in our documentation.

Help with Manim

If you need help installing or using Manim, feel free to reach out to our Discord Server or Reddit Community. If you would like to submit a bug report or feature request, please open an issue.

Contributing

Contributions to Manim are always welcome. In particular, there is a dire need for tests and documentation. For contribution guidelines, please see the documentation.

However, please note that Manim is currently undergoing a major refactor. In general, contributions implementing new features will not be accepted in this period. The contribution guide may become outdated quickly; we highly recommend joining our Discord server to discuss any potential contributions and keep up to date with the latest developments.

Most developers on the project use uv for management. You'll want to have uv installed and available in your environment. Learn more about uv at its documentation and find out how to install manim with uv at the manim dev-installation guide in the manim documentation.

How to Cite Manim

We acknowledge the importance of good software to support research, and we note that research becomes more valuable when it is communicated effectively. To demonstrate the value of Manim, we ask that you cite Manim in your work. Currently, the best way to cite Manim is to go to our repository page (if you aren't already) and click the "cite this repository" button on the right sidebar. This will generate a citation in your preferred format, and will also integrate well with citation managers.

Code of Conduct

Our full code of conduct, and how we enforce it, can be read on our website.

License

The software is double-licensed under the MIT license, with copyright by 3blue1brown LLC (see LICENSE), and copyright by Manim Community Developers (see LICENSE.community).

Owner

  • Name: Manim Community
  • Login: ManimCommunity
  • Kind: organization
  • Email: contact@manim.community

Citation (CITATION.cff)

# YAML 1.2
---
authors:
  -
    name: "The Manim Community Developers"
cff-version: "1.2.0"
date-released: 2025-01-20
license: MIT
message: "We acknowledge the importance of good software to support research, and we note that research becomes more valuable when it is communicated effectively. To demonstrate the value of Manim, we ask that you cite Manim in your work."
title: Manim – Mathematical Animation Framework
url: "https://www.manim.community/"
version: "v0.19.0"
...

Committers

Last synced: 6 months ago

All Time
  • Total Commits: 5,229
  • Total Committers: 454
  • Avg Commits per committer: 11.518
  • Development Distribution Score (DDS): 0.638
Past Year
  • Commits: 141
  • Committers: 46
  • Avg Commits per committer: 3.065
  • Development Distribution Score (DDS): 0.823
Top Committers
Name Email Commits
Grant Sanderson g****t@3****m 1,891
Benjamin Hackl d****l@b****t 251
Devin Neal d****n@e****m 233
leotrs l****o@l****m 208
Syrus Dark n****n@s****e 207
Ben Hambrecht b****r@g****m 150
kolibril13 4****3 150
Hugues Devimeux 3****x 108
Aathish a****4@g****m 102
pre-commit-ci[bot] 6****] 81
Sridhar Ramesh s****r@3****m 80
Ben Hambrecht b****n@h****h 74
adeshpande 1****2 67
Aathish Sivasubrahmanian a****s@A****l 54
Laith Bahodi 7****m 53
Darylgolden d****n@g****m 49
Ryan McCauley 3****1 45
Philipp Imhof f****u@f****h 42
nilaybhatia b****y@g****m 39
Aron Fischer c****b 34
Francisco Manríquez Novoa 4****0 33
dependabot[bot] 4****] 33
MysaaJava s****n@n****m 33
safinsingh s****h@g****m 31
kilacoda 6****a 26
icedcoffeeee 8****e 24
Jason Villanueva a@j****m 24
ad_chaos 9****v 23
azarzadavila 3****a 23
Nikhil Garuda 3****4 22
and 424 more...

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 591
  • Total pull requests: 1,075
  • Average time to close issues: 9 months
  • Average time to close pull requests: about 2 months
  • Total issue authors: 419
  • Total pull request authors: 200
  • Average comments per issue: 2.33
  • Average comments per pull request: 1.25
  • Merged pull requests: 625
  • Bot issues: 1
  • Bot pull requests: 128
Past Year
  • Issues: 181
  • Pull requests: 412
  • Average time to close issues: 17 days
  • Average time to close pull requests: 18 days
  • Issue authors: 143
  • Pull request authors: 91
  • Average comments per issue: 0.81
  • Average comments per pull request: 0.69
  • Merged pull requests: 193
  • Bot issues: 0
  • Bot pull requests: 21
Top Authors
Issue Authors
  • JasonGrace2282 (19)
  • MrDiver (18)
  • uwezi (17)
  • behackl (13)
  • ubaldot (10)
  • Darylgolden (6)
  • PrinceSajjadHussain (6)
  • tobiasBora (5)
  • ChungLeeCN (5)
  • chopan050 (4)
  • jeertmans (4)
  • kolibril13 (4)
  • Srikar-Ganta (4)
  • jsonvillanueva (3)
  • huguesdevimeux (3)
Pull Request Authors
  • JasonGrace2282 (182)
  • chopan050 (94)
  • dependabot[bot] (76)
  • behackl (61)
  • pre-commit-ci[bot] (52)
  • henrikmidtiby (51)
  • irvanalhaq9 (48)
  • MrDiver (28)
  • fmuenkel (18)
  • SirJamesClarkMaxwell (14)
  • barollet (11)
  • kira-offgrid (10)
  • biinnnggggg (9)
  • Viicos (9)
  • naveen521kk (9)
Top Labels
Issue Labels
issue:bug (82) new feature (73) installation (38) enhancement (35) good first issue (27) documentation (20) maintenance (12) opengl (9) refactor (7) tracking (6) needs discussion (6) experimental (4) easy (3) hacktoberfest (3) help wanted (3) testing (3) infrastructure (3) invalid (2) Suggestion (2) pr:dependent (2) SVG (2) cairo (1) breaking changes (1) to be closed down (1) question (1) performance (1) pr:bugfix (1) test requested (1) pr:deprecation (1) dependencies (1)
Pull Request Labels
maintenance (110) documentation (100) dependencies (95) pr:bugfix (81) enhancement (73) python (54) new feature (42) performance (38) pr:easy review (37) experimental (31) typehints (27) github_actions (26) refactor (22) breaking changes (20) opengl (13) needs discussion (9) testing (6) release (5) help wanted (5) pr:deprecation (4) infrastructure (4) easy (3) highlight (2) Proposal (2) dependent (2) cairo (1) pr:dependent (1) Suggestion (1)

Packages

  • Total packages: 6
  • Total downloads:
    • pypi 61,925 last-month
  • Total docker downloads: 254
  • Total dependent packages: 33
    (may contain duplicates)
  • Total dependent repositories: 97
    (may contain duplicates)
  • Total versions: 102
  • Total maintainers: 7
pypi.org: manim

Animation engine for explanatory math videos.

  • Versions: 29
  • Dependent Packages: 33
  • Dependent Repositories: 95
  • Downloads: 60,963 Last month
  • Docker Downloads: 254
Rankings
Stargazers count: 0.1%
Dependent packages count: 0.6%
Forks count: 1.2%
Average: 1.4%
Dependent repos count: 1.5%
Downloads: 2.5%
Docker downloads count: 2.8%
Maintainers (3)
Last synced: 4 months ago
proxy.golang.org: github.com/ManimCommunity/manim
  • Versions: 27
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 4 months ago
pypi.org: manimce

[Deprecated] Animation engine for explanatory math videos.

  • Versions: 5
  • Dependent Packages: 0
  • Dependent Repositories: 2
  • Downloads: 923 Last month
Rankings
Stargazers count: 0.1%
Forks count: 1.2%
Downloads: 5.4%
Average: 5.7%
Dependent packages count: 10.1%
Dependent repos count: 11.5%
Maintainers (3)
Last synced: 4 months ago
proxy.golang.org: github.com/manimcommunity/manim
  • Versions: 27
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 6.1%
Average: 6.3%
Dependent repos count: 6.5%
Last synced: 4 months ago
pypi.org: manim-community-auoie

Animation engine for explanatory math videos.

  • Versions: 13
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 18 Last month
Rankings
Stargazers count: 0.1%
Forks count: 1.2%
Dependent packages count: 6.6%
Average: 13.2%
Downloads: 27.5%
Dependent repos count: 30.6%
Maintainers (1)
Last synced: 4 months ago
pypi.org: anim-community-auoie

Animation engine for explanatory math videos.

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 21 Last month
Rankings
Stargazers count: 0.1%
Forks count: 1.2%
Dependent packages count: 6.6%
Average: 15.9%
Dependent repos count: 30.6%
Downloads: 41.1%
Maintainers (1)
Last synced: 4 months ago

Dependencies

.github/workflows/cffconvert.yml actions
  • actions/checkout v3 composite
  • citation-file-format/cffconvert-github-action 2.0.0 composite
.github/workflows/ci.yml actions
  • FedericoCarboni/setup-ffmpeg v2 composite
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • awalsh128/cache-apt-pkgs-action latest composite
  • codecov/codecov-action v3 composite
  • ssciwr/setup-mesa-dist-win v1 composite
  • teatimeguest/setup-texlive-action v2 composite
.github/workflows/codeql.yml actions
  • actions/checkout v3 composite
  • github/codeql-action/analyze v2 composite
  • github/codeql-action/autobuild v2 composite
  • github/codeql-action/init v2 composite
.github/workflows/dependent-issues.yml actions
  • z0al/dependent-issues v1 composite
.github/workflows/publish-docker.yml actions
  • docker/build-push-action v3 composite
  • docker/login-action v2 composite
  • docker/setup-buildx-action v2 composite
  • docker/setup-qemu-action v2 composite
.github/workflows/python-publish.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
  • actions/upload-release-asset v1 composite
docker/Dockerfile docker
  • python 3.8-slim build
docs/requirements.txt pypi
  • furo *
  • myst-parser *
  • sphinx <5.1
  • sphinx-copybutton *
  • sphinxext-opengraph *
docs/rtd-requirements.txt pypi
  • jupyterlab *
  • sphinxcontrib-programoutput *
poetry.lock pypi
  • 216 dependencies
pyproject.toml pypi
  • Sphinx ^4 develop
  • black >=20.8b1 develop
  • data-science-types ^0.2.23 develop
  • flake8 ^3.9.0 develop
  • flake8-bugbear ^21.4.3 develop
  • flake8-builtins ^1.5.3 develop
  • flake8-comprehensions ^3.7.0 develop
  • flake8-docstrings ^1.6.0 develop
  • flake8-pytest-style ^1.5.0 develop
  • flake8-rst-docstrings ^0.2.3 develop
  • flake8-simplify ^0.14.1 develop
  • furo ^2022.06.21 develop
  • gitpython ^3 develop
  • isort ^5.8.0 develop
  • matplotlib ^3.3.2 develop
  • mypy ^0.931 develop
  • myst-parser ^0.17.2 develop
  • pre-commit ^2.11.1 develop
  • psutil ^5.8.0 develop
  • psutil-wheels 5.8.0 develop
  • pygithub ^1 develop
  • pylint ^2.12.2 develop
  • pytest ^7.2 develop
  • pytest-cov ^3.0.0 develop
  • pytest-xdist ^2.2 develop
  • recommonmark ^0.7.1 develop
  • sphinx-copybutton ^0.4.0 develop
  • sphinxcontrib-programoutput ^0.17 develop
  • sphinxext-opengraph ^0.5.1 develop
  • types-Pillow ^8.3.3 develop
  • types-Pygments ^2.9.2 develop
  • types-decorator ^0.1.7 develop
  • types-protobuf ^3.17.4 develop
  • types-requests ^2.25.6 develop
  • types-setuptools ^57.0.2 develop
  • Pillow >=9.1,<10.0
  • Pygments ^2.10.0
  • backports.cached-property ^1.0.1
  • click >=7.2,<=9.0
  • click-default-group ^1.2.2
  • cloup ^0.13.0
  • colour ^0.1.5
  • dearpygui ^1.3.1
  • decorator ^5.0.7
  • importlib-metadata ^4.10.0
  • isosurfaces 0.1.0
  • jupyterlab ^3.0
  • manimpango ^0.4.0.post0
  • mapbox-earcut ^1.0.0
  • moderngl ^5.6.3
  • moderngl-window ^2.3.0
  • networkx ^2.5
  • notebook ^6.4
  • numpy ^1.19
  • pycairo ^1.21
  • pydub ^0.25.1
  • python >=3.8,<3.12
  • requests ^2.26.0
  • rich >=6.0,!=12.0.0
  • scipy ^1.7.3
  • screeninfo ^0.8
  • skia-pathops ^0.7.0
  • srt ^3.5.0
  • svgelements ^1.8.0
  • tqdm ^4.62.3
  • watchdog ^2.1.6