Files

user bf45abcbad feat: initial implementation

Asyncio IRC bot with decorator-based plugin system.
Zero external dependencies, Python 3.11+.

- IRC protocol: message parsing, formatting, async TCP/TLS connection
- Plugin system: @command and @event decorators, file-based loading
- Bot orchestrator: connect, dispatch, reconnect, nick recovery
- CLI: argparse entry point with TOML config
- Built-in plugins: ping, help, version, echo
- 28 unit tests for parser and plugin system

2026-02-15 00:37:31 +01:00

666 B

Raw Blame History

Installation

Prerequisites

Python 3.11+
git

Setup

cd ~/git/derp
make install

This creates a .venv, installs derp in editable mode, and adds dev tools.

Symlink

make link

Installs derp to ~/.local/bin/. Verify:

which derp
derp --version

Manual Install

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Configuration

Copy and edit the default config:

cp config/derp.toml ~/.config/derp/derp.toml
# Edit server, nick, channels

Config search order:

Path given via --config
./config/derp.toml
~/.config/derp/derp.toml
Built-in defaults

666 B Raw Blame History