Skip to main content

Asynchronous Component based Event Application Framework

Project description


circuits is a Lightweight Event driven and Asynchronous Application Framework for the Python Programming Language with a strong Component Architecture.

circuits also includes a lightweight, high performance and scalable HTTP/WSGI compliant web server as well as various I/O and Networking components.

To take full advantage of circuits and its architecture, circuits encourages you to design your application in terms of loosely coupled components. Circuits has a very powerful message passing system that enables components to interact with each other via events. Applications written this way tend to be more maintainable, easier to develop and scale to complex systems.

circuits’ Loosely Coupled Component Architecture allows for a high level of Reuse and Scalability. Simpler components can be combined together to form Complex Components and provide higher level functionality and abstraction. Much of the circuits component library is designed and built this way.


  • event driven
  • concurrency support
  • component architecture
  • asynchronous I/O components
  • no required external dependencies
  • full featured web framework (circuits.web)
  • coroutine based synchronization primitives


Supported Platforms

  • Linux, FreeBSD, Mac OS X, Windows
  • Python 2.6, 2.7, 3.2, 3.3
  • pypy 2.0


The simplest and recommended way to install circuits is with pip. You may install the latest stable release from PyPI with pip:

> pip install circuits

If you do not have pip, you may use easy_install:

> easy_install circuits

Alternatively, you may download the source package from the PyPi Page or the Downloads page on the Website; extract it and install using:

> python install


circuits is licensed under the MIT License.


We welcome any questions or feedback about bugs and suggestions on how to improve circuits. Let us know what you think about circuits. @pythoncircuits.

Do you have suggestions for improvement? Then please Create an Issue with details of what you would like to see. I’ll take a look at it and work with you to either incorporate the idea or find a better solution.


There is also a small community of circuits enthusiasts that you may find on the #circuits IRC Channel on the FreeNode IRC Network and the Mailing List.

Release Notes - circuits-2.1.0 (<release>)

This release adds the following new features to circuits:

  • Python 3 support.
  • Windows support.
  • PyPy support.
  • IPv6 support.
  • Better WSGI support.
  • Fully documented examples.
  • Component Interface querying.

And many bug fixes!

Download files

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

Source Distributions (1.8 MB view hashes)

Uploaded source

circuits-2.1.0.tar.gz (1.3 MB view hashes)

Uploaded source

circuits-2.1.0.tar.bz2 (1.1 MB view hashes)

Uploaded source

Built Distributions

circuits-2.1.0-py3.3.egg (526.7 kB view hashes)

Uploaded 3 3

circuits-2.1.0-py3.2.egg (513.3 kB view hashes)

Uploaded 3 2

circuits-2.1.0-py2.7.egg (506.9 kB view hashes)

Uploaded 2 7

circuits-2.1.0-py2.6.egg (507.3 kB view hashes)

Uploaded 2 6

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page