Skip to main content

Pymunk is a easy-to-use pythonic 2d physics library

Project description

Pymunk is a easy-to-use pythonic 2d physics library that can be used whenever you need 2d rigid body physics from Python. Perfect when you need 2d physics in your game, demo or simulation! It is built on top of the very capable 2d physics library Chipmunk.

The first version was released in 2007 and Pymunk is still actively developed and maintained today, more than 10 years of active development!

Pymunk has been used with success in many projects, big and small. For example: 3 Pyweek game competition winners, more than a dozen published scientific papers and even in a self-driving car simulation! See the Showcases section on the Pymunk webpage for some examples.

2007 - 2022, Victor Blomqvist -, MIT License

This release is based on the latest Pymunk release (6.4.0), using Chipmunk 7 rev 0593976ef47fcb3957166bd342f6b2bafe4d0e44 .


In the normal case pymunk can be installed from PyPI with pip:

> pip install pymunk

It has one direct dependency, CFFI.

Pymunk can also be installed with conda, from the conda-forge channel:

> conda install -c conda-forge pymunk


Quick code example:

import pymunk               # Import pymunk..

space = pymunk.Space()      # Create a Space which contain the simulation
space.gravity = 0,-981      # Set its gravity

body = pymunk.Body()        # Create a Body
body.position = 50,100      # Set the position of the body

poly = pymunk.Poly.create_box(body) # Create a box shape and attach to body
poly.mass = 10              # Set the mass on the shape
space.add(body, poly)       # Add both body and shape to the simulation

print_options = pymunk.SpaceDebugDrawOptions() # For easy printing

while True:                 # Infinite loop simulation
    space.step(0.02)        # Step the simulation one step forward
    space.debug_draw(print_options) # Print the state of the simulation

For more detailed and advanced examples, take a look at the included demos. They are included in the pymunk install, in the pymunk.examples subpackage. They can be run directly. To list the examples:

> python -m pymunk.examples -l

And to run one of them:

> python -m pymunk.examples.breakout


The full documentation including API reference, showcase of usages and screenshots of examples is available on the Pymunk homepage,

The Pymunk Vision

Make 2d physics easy to include in your game

It is (or is striving to be):

  • Easy to use - It should be easy to use, no complicated code should be needed to add physics to your game or program.

  • “Pythonic” - It should not be visible that a c-library (Chipmunk) is in the bottom, it should feel like a Python library (no strange naming, OO, no memory handling and more)

  • Simple to build & install - You shouldn’t need to have a zillion of libraries installed to make it install, or do a lot of command line tricks.

  • Multi-platform - Should work on both Windows, *nix and OSX.

  • Non-intrusive - It should not put restrictions on how you structure your program and not force you to use a special game loop, it should be possible to use with other libraries like Pygame and Pyglet.

Contact & Support



You can ask questions/browse old ones at Stackoverflow, just look for the Pymunk tag.


You can email me directly at

Issue Tracker

Please use the issue tracker at github to report any issues you find. This is also the place for feature requests:

Regardless of the method you use I will try to answer your questions as soon as I see them. (And if you ask on SO other people might help as well!)

Dependencies / Requirements

Basically Pymunk have been made to be as easy to install and distribute as possible, usually pip install will take care of everything for you.

  • Python (Runs on CPython 3.6 and later and Pypy3)

  • Chipmunk (Compiled library already included on common platforms)

  • CFFI (will be installed automatically by Pip)

  • Setuptools (should be included with Pip)

  • GCC and friends (optional, you need it to compile Pymunk from source. On windows Visual Studio is required to compile)

  • Pygame (optional, you need it to run the Pygame based demos)

  • Pyglet (optional, you need it to run the Pyglet based demos)

  • Matplotlib & Jupyter Notebook (optional, you need it to run the Matplotlib based demos)

  • Sphinx & aafigure & sphinx_autodoc_typehints (optional, you need it to build documentation)

Python 2 Support

Support for Python 2 (and Python 3.0 - 3.5) has been dropped with Pymunk 6.0. If you use these legacy versions of Python, please use Pymunk 5.x.

Install from source / Chipmunk Compilation

This section is only required in case you do not install pymunk from the prebuild binary wheels (normally if you do not use pip install or you are on a uncommon platform).

Pymunk is built on top of the c library Chipmunk. It uses CFFI to interface with the Chipmunk library file. Because of this Chipmunk has to be compiled together with Pymunk as an extension module.

There are basically two options, either building it automatically as part of installation using for example Pip:

> pip install

Or if you have the source unpacked / you got Pymunk by cloning its git repo, you can explicitly tell Pymunk to compile it inplace:

> python build_ext --inplace

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution (7.7 MB view hashes)

Uploaded source

Built Distributions

pymunk-6.4.0-pp39-pypy39_pp73-win_amd64.whl (274.4 kB view hashes)

Uploaded pp39

pymunk-6.4.0-cp311-cp311-win_amd64.whl (328.9 kB view hashes)

Uploaded cp311

pymunk-6.4.0-cp311-cp311-win32.whl (278.1 kB view hashes)

Uploaded cp311

pymunk-6.4.0-cp311-cp311-musllinux_1_1_i686.whl (955.3 kB view hashes)

Uploaded cp311

pymunk-6.4.0-cp311-cp311-macosx_11_0_arm64.whl (317.4 kB view hashes)

Uploaded cp311

pymunk-6.4.0-cp311-cp311-macosx_10_9_x86_64.whl (323.8 kB view hashes)

Uploaded cp311

pymunk-6.4.0-cp310-cp310-win_amd64.whl (328.9 kB view hashes)

Uploaded cp310

pymunk-6.4.0-cp310-cp310-win32.whl (278.1 kB view hashes)

Uploaded cp310

pymunk-6.4.0-cp310-cp310-musllinux_1_1_i686.whl (955.1 kB view hashes)

Uploaded cp310

pymunk-6.4.0-cp310-cp310-macosx_11_0_arm64.whl (317.4 kB view hashes)

Uploaded cp310

pymunk-6.4.0-cp310-cp310-macosx_10_9_x86_64.whl (323.8 kB view hashes)

Uploaded cp310

pymunk-6.4.0-cp39-cp39-win_amd64.whl (328.9 kB view hashes)

Uploaded cp39

pymunk-6.4.0-cp39-cp39-win32.whl (278.1 kB view hashes)

Uploaded cp39

pymunk-6.4.0-cp39-cp39-musllinux_1_1_i686.whl (955.2 kB view hashes)

Uploaded cp39

pymunk-6.4.0-cp39-cp39-macosx_11_0_arm64.whl (317.4 kB view hashes)

Uploaded cp39

pymunk-6.4.0-cp39-cp39-macosx_10_9_x86_64.whl (323.8 kB view hashes)

Uploaded cp39

pymunk-6.4.0-cp38-cp38-win_amd64.whl (328.9 kB view hashes)

Uploaded cp38

pymunk-6.4.0-cp38-cp38-win32.whl (278.1 kB view hashes)

Uploaded cp38

pymunk-6.4.0-cp38-cp38-musllinux_1_1_i686.whl (955.7 kB view hashes)

Uploaded cp38

pymunk-6.4.0-cp38-cp38-macosx_11_0_arm64.whl (317.4 kB view hashes)

Uploaded cp38

pymunk-6.4.0-cp38-cp38-macosx_10_9_x86_64.whl (323.8 kB view hashes)

Uploaded cp38

pymunk-6.4.0-cp37-cp37m-win_amd64.whl (328.9 kB view hashes)

Uploaded cp37

pymunk-6.4.0-cp37-cp37m-win32.whl (278.1 kB view hashes)

Uploaded cp37

pymunk-6.4.0-cp36-cp36m-win_amd64.whl (345.2 kB view hashes)

Uploaded cp36

pymunk-6.4.0-cp36-cp36m-win32.whl (293.6 kB view hashes)

Uploaded cp36

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page