An IRC and ActivityPub bot which links identities.
William Pitcock 9016e3ead7 irc: fix ap config 1 year ago
viera irc: fix ap config 1 year ago
.gitignore add database and config to gitignore 2 years ago
LICENSE Initial commit 2 years ago
Pipfile pipfile: delete python version requirement, because reasons 2 years ago
Pipfile.lock pipfile: delete python version requirement, because reasons 2 years ago README: note Python >= 3.5.2 requirement 2 years ago
requirements.txt add requirements.txt file 2 years ago
viera.yaml.example irc: allow tls certificate verification to be bypassed 1 year ago


A useful IRC and ActivityPub bot which links identities and relays messages.


viera is copyrighted, but free software, licensed under the terms of the GNU Affero General Public License version 3 (AGPLv3) license. You can find a copy of it in this package as the LICENSE file.


You need at least Python 3.5 (3.5.2 or newer recommended) to make use of this software. It simply will not run on older Python versions.

viera uses the new pipenv python environment manager, you should install it before trying to make use of this software:

$ pip3 install pipenv

Next, create the virtual environment for viera to use:

$ pipenv install

Next, copy viera.yaml.example to viera.yaml and edit it as appropriate:

$ cp viera.yaml.example viera.yaml
$ $EDITOR viera.yaml

Finally, you can launch viera:

$ pipenv run python3 -m viera

It is suggested to run this under some sort of supervisor, such as runit, daemontools, s6 or systemd. Configuration of the supervisor is not covered here, as it is different depending on which system you have available.

The bot runs a webserver, internally, on localhost at port 8080. This needs to be forwarded by nginx or similar. The webserver is used to receive ActivityPub messages, and needs to be secured with an SSL certificate inside nginx or similar. Configuration of your webserver is not discussed here, but any guide explaining how to configure a modern non-PHP web application should cover it.

Getting started

It is required to register a services account for the bot. This is different depending on the IRC network in use.

It is also required to use SASL to authenticate to the IRC network. This is supported on most IRC networks.

viera works with ActivityPub identities as the primary source of trust. This means that you are required to link an ActivityPub identity to your IRC identity in order to authenticate to the bot. To do that, make sure you are logged into your NickServ or similar account and message the bot on IRC:

/msg yourbot auth

The bot will respond with an authentication token that you must supply via the fediverse, in most cases you can just copy and paste the exact message it provides.

Following accounts to relay to IRC

Once you have authenticated to an AP identity which is listed in the privileged group in the config file, you may configure the bot to follow accounts, by using the follow command:

/msg yourbot follow

This will cause your bot to request an ActivityPub connection between itself and the user you followed. In most cases this will be set up immediately, but in some cases, there may be a delay, such as when accounts are restricted.

If you want the bot to stop following an account, you can use the unfollow command:

/msg yourbot unfollow