Skip to main content

pymunk - 0.8.4

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: 2 Pyweek game competition winners, more than 10 published scientific papers and even in a self-driving car simulation!

The easiest way to install Pymunk is with pip install:
pip install pymunk -U
It has one (or two) dependencies. CFFI and if not on Windows or OSX you also need a working gcc compiler.

For full docs, examples and updates, go to!

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


Changes from the previous release:
  • Fixed float infinity issue which made pymunk not work on python 2.5.
If you experience any problem with the windows installer, please try the msi installers (one for py2.5 and one for py2.6). You can find download links on the homepage.



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.1.0 — 18 Jan, 2017 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