Skip to main content

A demonstration of the Poe protocol using aiohttp

Project description


An implementation of the Poe protocol using aiohttp.

To run it:

  • Create a virtual environment (Python 3.7 or higher)
  • pip install .
  • python -m aiohttp_poe
  • In a different terminal, run ngrok to make it publicly accessible

Write your own bot

This package can also be used as a base to write your own bot. You can inherit from aiohttp_poe.PoeBot to make a bot:

from aiohttp_poe import PoeBot, run

class EchoBot(PoeBot):
    async def get_response(self, query, request):
        last_message = query["query"][-1]["content"]
        yield self.text_event(last_message)

if __name__ == "__main__":

Enable authentication

Poe servers send requests containing Authorization HTTP header in the format "Bearer <api_key>," where api_key is the API key configured in the bot settings. \

To validate the requests are from Poe Servers, you can either set the environment variable POE_API_KEY or pass the parameter api_key in the run function like:

if __name__ == "__main__":
    run(EchoBot(), api_key=<key>)

For a more advanced example that exercises more of the Poe protocol, see Catbot.

Project details

Download files

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

Source Distribution

aiohttp_poe-0.0.14.tar.gz (4.5 kB view hashes)

Uploaded Source

Built Distribution

aiohttp_poe-0.0.14-py3-none-any.whl (6.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page