A 心から educational MVC python web framework
Python CSS JavaScript Other
Failed to load latest commit information.
applications fix up things Jan 3, 2015
kokoropy more robbust unicode processing, multiple token can be recognized Jan 13, 2015
.gitignore remove unused exclamation mark Aug 28, 2013
LICENSE.txt fix path Dec 13, 2014
Procfile use relative import Feb 3, 2014
heroku_app.py restructure application convention Mar 24, 2014
requirements.txt fix show view Jun 17, 2014
runtime.txt use relative import Feb 3, 2014
setup.cfg fix path Dec 13, 2014
setup.py fix path Dec 13, 2014



A 心から Educational MVC Python Web Framework.

In japanese, kokoro means heart. I make Kokoropy because I can not find any python web-framework which I really comfort with. Some are too verbose, while some others have too many "magic". Most of them force me to learn about the framework, and do not allow me to directly focus on my job. Basically I expect an easy-to-use framework like CodeIgniter (with more features) in python.

If you are in the same boat with me, then kokoropy is also for you.

Kokoropy is built in top of Bottle.py (http://bottlepy.org/docs/dev/), a very great python micro-web-framework. While bottle.py focus on how to make things as simple as possible, kokoropy focus on how to make things as easy as possible.

Kokoropy is built based on my experiences with some framework. Here are some comparison between kokoropy and other framework

  • Kokoropy is explicit & transparent. There is no magic in kokoropy. If you need something, you need to import it.
  • You can use route directive just like in bottle.py (http://bottlepy.org), since bottle.py is the core of kokoropy.
  • Kokoropy is built based on HMVC pattern. You can make unlimited number of separated MVC triad. This is good to make your application maintainable.
  • Kokoropy doesn't have any other dependencies beside python-standard-library. You can even run it without Apache or nginx.
  • Kokoropy support many database system. Every model can has its own database.
  • Kokoropy support REST.
  • Kokoropy support both, automatic and manual routing.
  • Kokoropy support SESSION and COOKIES out of the box

PS: This is my pet-project, and might be not stable. It is not ready for production purpose (yet)

Kokoropy stands in the shoulder of the giants. Here are projects that make kokoropy possible:

Also, kokoropy come with several third-party css & javascript framework (so you do not need to download them anymore):

  • autosize
  • jquery-ui-bootstrap
  • leaflet 0.7.2
  • jquery-ace 1.0.3

Documentation & Demo


Who Kokoropy is for?

Kokoropy is for you if you:

  • Already familiar with PHP framework such as CodeIgniter but want to move to Python.
  • Want to have a "educational" web framework that can be run everywhere.
  • Desire explicity of framework, so that popular IDE such as eclipse can help in auto-completion (intellisense).
  • Don't like complicated framework, you want a framework with small learning steep.
  • Want an automatic migration for development.
  • Want a magical generator (under construction).

Change Log:

  • Provide base_url setting (done, tested, 2013/08/08)
  • In debugging session (via python start.py), auto reload server when something changed (done, tested, 2013/08/08)
  • Add request.BASE_URL to every view & link in the example (done, tested, 2013/08/09)


  • Make CRUD generator


  • Marcel Hellkamp (defnull): creator of bottlepy
  • Rully Ramanda: Introducing relative import to me :)
  • Creator of sqlalchemy, jquery, and anyone who let me make kokoropy easier