skip to navigation
skip to content

Not Logged In

aiohttp 0.16.6

http client/server for asyncio

http client/server for asyncio


  • Supports both client and server side of HTTP protocol.
  • Supports both client and server Web-Sockets out-of-the-box.
  • Web-server has middlewares and pluggable routing.



aiohttp is offered under the Apache 2 license.

Source code

The latest developer version is available in a github repository:

Getting started


To retrieve something from the web:

import aiohttp
import asyncio

def get_body(url):
    response = yield from aiohttp.request('GET', url)
    return (yield from

if __name__ == '__main__':
    loop = asyncio.get_event_loop()
    raw_html = loop.run_until_complete(get_body(''))

You can use the get command like this anywhere in your asyncio powered program:

response = yield from aiohttp.request('GET', '')
body = yield from

If you want to use timeouts for aiohttp client side please use standard asyncio approach:

yield from asyncio.wait_for(request('GET', url), 10)


In aiohttp 0.12 we’ve added highlevel API for web HTTP server.

This is simple usage example:

import asyncio
from aiohttp import web

def handle(request):
    name = request.match_info.get('name', "Anonymous")
    text = "Hello, " + name
    return web.Response(body=text.encode('utf-8'))

def wshandler(request):
    ws = web.WebSocketResponse()

    while True:
        msg = yield from ws.receive()

        if == web.MsgType.text:
            ws.send_str("Hello, {}".format(
        elif == web.MsgType.binary:
        elif == web.MsgType.close:

    return ws

def init(loop):
    app = web.Application(loop=loop)
    app.router.add_route('GET', '/echo', wshandler)
    app.router.add_route('GET', '/{name}', handle)

    srv = yield from loop.create_server(app.make_handler(), '', 8080)
    print("Server started at")
    return srv

loop = asyncio.get_event_loop()


0.16.6 (07-15-2015)

  • Skip compilation on Windows if vcvarsall.bat cannot be found #438

0.16.5 (06-13-2015)

  • Get rid of all comprehensions and yielding in _multidict #410

0.16.4 (06-13-2015)

  • Don’t clear current exception in multidict’s __repr__ (cythonized versions) #410

0.16.3 (05-30-2015)

  • Fix StaticRoute vulnerability to directory traversal attacks #380

0.16.2 (05-27-2015)

  • Update python version required for __del__ usage: it’s actially

    3.4.1 instead of 3.4.0

  • Add check for presence of loop.is_closed() method before call the former #378

0.16.1 (05-27-2015)

  • Fix regression in static file handling #377

0.16.0 (05-26-2015)

  • Unset waiter future after cancellation #363
  • Update request url with query parameters #372
  • Support new fingerprint param of TCPConnector to enable verifying ssl certificates via md5, sha1, or sha256 digest #366
  • Setup uploaded filename if field value is binary and transfer encoding is not specified #349
  • Implement ClientSession.close() method
  • Implement connector.closed readonly property
  • Implement ClientSession.closed readonly property
  • Implement ClientSession.connector readonly property
  • Implement ClientSession.detach method
  • Add __del__ to client-side objects: sessions, connectors, connections, requests, responses.
  • Refactor connections cleanup by connector #357
  • Add limit parameter to connector constructor #358
  • Add request.has_body property #364
  • Add response_class parameter to ws_connect() #367
  • ProxyConnector doesn’t support keep-alive requests by default starting from now #368
  • Add connector.force_close property
  • Add ws_connect to ClientSession #374
  • Support optional chunk_size parameter in router.add_static()
File Type Py Version Uploaded on Size
aiohttp-0.16.6.tar.gz (md5) Source 2015-07-15 1MB
  • Downloads (All Versions):
  • 1032 downloads in the last day
  • 5914 downloads in the last week
  • 20818 downloads in the last month