Files

user ced6232373 feat: initial IRC bouncer implementation

Async Python IRC bouncer with SOCKS5 proxy support, multi-network
connections, password auth, and persistent SQLite backlog with replay.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-19 11:29:59 +01:00

814 B

Raw Blame History

Installation

Prerequisites

Python 3.10+
SOCKS5 proxy running on 127.0.0.1:1080

Setup

cd ~/git/bouncer
make dev

This creates .venv/, installs dependencies, and registers the bouncer command.

Verify

bouncer --version

Configuration

cp config/bouncer.example.toml config/bouncer.toml

Edit config/bouncer.toml with your network details. At minimum, set:

bouncer.password -- client authentication password
networks.<name>.host -- IRC server hostname
networks.<name>.nick -- your IRC nickname
networks.<name>.channels -- channels to auto-join

Symlink

The make dev editable install registers bouncer in .venv/bin/. To make it available system-wide:

ln -sf ~/git/bouncer/.venv/bin/bouncer ~/.local/bin/bouncer

814 B Raw Blame History