Skip to main content

pymunk - 1.0.0

Pymunk is a easy-to-use pythonic 2d physics library that can be used whenever you need 2d rigid body physics from Python.

Victor Blomqvist

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 other application! 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.

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.

The easiest way to install Pymunk is with pip install:
pip install pymunk -U
It has one direct dependency. CFFI.

For full docs, examples and updates, go to!

The release list here is not always up to date. Make sure to use pip install as described above, or visit the Pymunk homepage for the latest version!


With this release pymunk has most features I wanted, follows the latest chipmunk version, has quite good api documentation and is fairly well tested and hopefully quite stable. As such I think it's about time the version is bumped to 1.0.0.

As this version is updated to include the new features in chipmunk, and also contain at least one breaking change it is not unlikely that it will break your code. On the other hand, now it has the newest callback system (see Space.add_collision_handler), new joints and other cool stuff that will make it easier and more fun to include 2d physics into your program/game :)

Changes from the last release:

  • * Vec2d now uses radians instead of degrees for all default angle functions. This might break existing code!
  • * Upgraded to latest chipmunk. This means new system of callbacks and many other fixes
  • * Many unittests added.
  • * Better py3k compatibility (everything except for the setup script should work)
  • * Better 32/64 bit handling
  • * and more



pymunk 0.8 — 15 Jun, 2008

pymunk 0.8.1 — 1 Nov, 2008

pymunk 0.8.2 — 22 Apr, 2009

pymunk 0.8.4 — 16 Aug, 2009

pymunk 0.8.3 — 26 Jul, 2009

pymunk 1.0.0 — 17 Mar, 2010

pymunk 3.0.0 — 2 Sep, 2012

pymunk 4.0.0 — 25 Aug, 2013

pymunk 5.4.2 — 13 Jan, 2019

pymunk 5.5.0 — 4 May, 2019

pymunk 5.6.0 — 12 Nov, 2019 account Comments

  • Viblo 2011-05-03 10:56:54

    If you are using pymunk you might be happy to hear that a new (major) release of pymunk is coming soon. In case you have some time over during the next couple of days, please give the latest svn version of pymunk a try and give me some comments on how it feels. Check this post I made on the chipmunk forums for a little more details:

    renesd 2011-05-03 14:24:50


    on apple python I get an error...
    OSError: dlopen(/Library/Python/2.6/site-packages/pymunk/libchipmunk.dylib, 6): image not found

    It seems is there instead. I installed with python install


    Viblo 2011-05-08 06:13:38

    Problem is that I don't ship the libchipmunk.dylib file with pymunk. Therefor you have to compile it yourself, with the build_chipmunk command (and after that you might need to rerun the install):

    >python build_chipmunk

    Right now I only have a MS Vista laptop, together with a Win Server 2008 machine at work, so Im only able to copmile Chipmunk on Windows and Linux, meaning I can include a .dll for windows, and a .so file for 32bit linux. (Linux running in virtual box VM, unfortunately its not possible to run OSX hosted as a VM in a good way because of Apples restrictions).

    I wonder if you got an error message with roughly this explanation when it failed? I think I have some code for it, but it would be good to hear if it works in practive, and if/how I can improve it to make it more obvious for users?

  • Fla5h 2013-03-14 23:37:32

    I'm having trouble rotating my circle while moving it with the keys. Can someone please help?

  • Lexter Freile 2017-12-20 18:47:17.077485

    good library
  • Berenguer 2019-05-05 09:25:54.653033

    Excellent !.