Production IRC automation

Mediabot v3

Give your IRC channel a memory. An open-source bot in Perl for useful links, messages that wait for people and the conversations worth keeping.

Stable 3.7 brings the plugin platform, the longest-word game, French Trivia and richer link previews together with documented installation, upgrades and per-channel controls.

Supported release 3.7 stable

Download the release archives, verify their checksums and follow the installation guide.

Download 3.7 →
Plugin workshop Perl plugins

Experimental Plugin API v3, explicit capabilities and per-channel controls.

Build a plugin →
A little less bot. A little more channel.

Useful things.
Good company.

Catch the link. Leave a message. Bring back that one perfect quote.

#i/o / Libera.Chat Illustrated demo

Links with context

<Mira> https://github.com/teuk/mediabot_v3

<Mediabot> Mediabot v3 · Open-source IRC bot in Perl

<Jules> oh, that’s the one you’ve been building?

The useful part of a link, right in the conversation.

Messages that wait

<Mira> !tell Jules The setup guide is on the wiki.

<Mediabot> I’ll pass that on when Jules returns.

<Jules> back!

<Mediabot> Jules: Mira left you a message: The setup guide is on the wiki.

People come and go. Their messages can stay.

The good bits, kept

<Jules> !quote Mira

<Mediabot> <Mira> “Five-minute fix” is a unit of optimism.

<Mira> unfortunately accurate.

Every channel has its classics. Keep yours.
Come say hello

The bot is already in #i/o. You’re welcome too.

Join us on Libera.Chat, try !help and tell Teuk what you think. English or French is fine.

New to IRC? Open the webchat and choose a nickname. If it’s quiet, leave your question and give people time to reply.

Join #i/o on Libera
Open IRC clientor, on Libera:
/join #i/o

Illustrative replies; available commands and features depend on the channel.

What it does

One runtime, four operational layers

01

IRC runtime

Resilient network handling, channel policy, roles, timers and controlled multi-network operation.

02

Community memory

Quotes, notes, reminders, facts, history and achievements backed by durable MariaDB state.

03

Conversation

Per-channel Hailo brains plus guarded OpenAI, Claude and Gemini helpers where communities opt in.

04

Operations

Systemd deployment, schema migrations, diagnostics, structured logs and Prometheus metrics.

Find your next step

Install, operate and contribute

01

First installation ↗

Choose stable 3.7 or development 3.8dev, verify the archive and configure your own instance.

02

Upgrade an instance ↗

Back up configuration and data, review migrations and keep a compatible rollback path.

03

Run and diagnose ↗

Give each instance its own configuration and service. Check application logs as well as process health.

04

Test a change ↗

Use targeted tests, then the full suite. Development qualification covers local IRC, injected faults and bounded endurance.

Engineering archive

Release and development notes

All GitHub releases ↗

Major refactoring milestone

After a long (very long) refactoring campaign, Mediabot finally migrated most of its command handling to a proper Context-based architecture. Yes, this includes: removing years of implicit state, surviving strict mode, fixing bugs that existed longer than some IRC networks, and arguing endlessly with ChatGPT (which…

Read the full note →

Charset and schema cleanup

I had to do this for a long time, sorry guys ALTER TABLE CHANNELLOG MODIFY ts DATETIME NOT NULL DEFAULT CURRENTTIMESTAMP; ALTER TABLE RESPONDERS MODIFY responder VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4unicodeci, MODIFY answer TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4unicodeci; ALTER TABLE CHANNEL MODIFY…

Read the full note →
Public repository

Recent GitHub activity

Updated 22/11/2026, 17:50:29