home > Welcome to web.py!

web.py is a web framework for Python that is as simple as it is powerful. web.py is in the public domain; you can use it for whatever purpose with absolutely no restrictions.

import web

urls = (
    '/(.*)', 'hello'
app = web.application(urls, globals())

class hello:
    def GET(self, name):
        if not name:
            name = 'World'
        return 'Hello, ' + name + '!'

if __name__ == "__main__":
A complete web.py application.

Get Started

web.py 0.39 is the latest released version of web.py. You can install it by running:

pip install web.py

The above version only supports Python 2. If you looking for Python 3 support, try the experimental version.

pip install web.py==0.40-dev1

Or to get the latest development version from git:

git clone git://github.com/webpy/webpy.git
ln -s `pwd`/webpy/web .

Who uses web.py?

web.py was originally published while Aaron Swartz worked at reddit.com, where the site used it as it grew to become one of the top 1000 sites according to Alexa and served millions of daily page views. “It’s the anti-framework framework. web.py doesn’t get in your way,” explained founder Steve Huffman. (The site was rewritten using other tools after being acquired by Condé Nast.)

Some user testimonials:

“In the ecosystem of web frameworks, something must occupy the niche of ‘small, light, and fast’: web.py does this.”
  —  Lloyd Dalton, colr.org

“We finished rewriting our server in only a fews days with web.py and it was everything we hoped for.”
  —  Sam Hsiung, YouOS

“[Web.py inspired the] web framework we use at FriendFeed [and] the webapp framework that ships with App Engine…”
  —  Brett Taylor, co-founder of FriendFeed and original tech lead on Google App Engine

“Django lets you write web apps in Django. TurboGears lets you write web apps in TurboGears. Web.py lets you write web apps in Python.”
  —  Alice Atlas

“Guido [van Rossum, creator of Python], you’ll probably find that web.py best suits your style. … If you don’t like it, I can’t imagine which of the other dozens of frameworks out there you would like.”
  —  Phillip J. Eby, creator of the Python Web Server Gateway Interface (WSGI) #

Websites utilizing web.py:

  • colr.org, A site for creating and playing with color schemes with API, powered by web.py.

  • jottit.com Jottit makes getting a website as easy as filling out a textbox.

  • URIs.us is a service for creating shortened urls. Deployed on Google App Engine.

  • Biomed Search Use keywords to search through more than one million biomedical images with linked sources.

  • Yandex, the leading Russian search engine (their homepage alone receives 70 million daily page views).

  • Make History, a project of the 9/11 Memorial Museum, is powered by web.py on top of Google App Engine. On September 11, 2009, it received nearly 200,000 visitors. “It’s my first time working with web.py and basically with Python,” noted its developer. “web.py was awesome.”

  • Oyster.com, a website that reviews and photographs hotels, uses web.py for the entire site. They note that “web.py gives us the control we need for a large-scale website”. As of Jan 2013, Oyster.com renders about 230,000 pages per day.

  • local.ch, the official online Telephone Directory for Switzerland - using web.py in a backend service for tracking expired content - code open-sourced as urldammit.