Skip to main content

A minimalist asynchronous IRC server

Project description


A minimalist python asynchronous IRC server built on top of Trio.

Installation and Usage

Download and install the latest stable version using pip. Windows users might replace python3 by py.

python3 -m pip install aioircd

Then run the server:

HOST= LOGLEVEL=INFO python3 -m aioircd

The configuration is done via environment variables, see --help:

optional arguments:
  -h, --help     show this help message and exit
  -V, --version  show program's version number and exit

environment variables:
  HOST           public domain name (default: julien-UX410UAR)
  ADDR           ip address to bind (default:
  PORT           port to bind (default: 6667)
  PASS           server password (default: )
  TIMEOUT        kick inactive users after x seconds (default: 60)
  PING_TIMEOUT   PING inactive users x seconds before timeout (default: 5)
  LOGLEVEL       logging verbosity (default: WARNING)


We try to both keep only implement the most important commands and to make sure all modern IRC clients are working. If you are having troubles using aioircd with your client feel free to open an issue.

Stuff we don't plan to support: server connections, user modes, channel modes.

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

aioircd-2.0.6.tar.gz (14.6 kB view hashes)

Uploaded source

Built Distribution

aioircd-2.0.6-py3-none-any.whl (13.2 kB view hashes)

Uploaded py3

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