IRC bot for fun, learning, creativity and collaboration.

One day an idea came up on the #freepost IRC channel: We didn't need much of the serious features IRC bots provide, but we could develop an IRC bot collaboratively, for fun and for learning new skills and languages! I also thought this is a great chance for people to quickly see their code in real use, which is motivating when learning programming, and it's a chance to introduce Haskell to the community.

While the bot is made for and by the Freepost community, it is fully intended for use any anyone else! For experienced Haskell developers, this bot can perhaps provide space for creativity and custom advanced plugins and features.

Since this bot is meant for collaborative development while really running it, the running instance in #freepost is built from the git repository. Occasionally releases will be made to Hackage. If you want to be sure you have all the latest features, check out the git repository (and/or ask us to make a release if you think it's been long enough).

funbot

An IRC bot for learning, fun and collaboration in the Freepost community. There is a project page here.

Using

See the .cabal file for more info and link to project website and version control.

The official download location is the Git repository:

https://notabug.org/fr33domlover/funbot.git

Occasionally, releases may be made to Hackage, the Haskell package repository. See http://hackage.haskell.org/package/funbot.

Some of the dependency libraries may have recent features not released to Hackage yet. See the guide linked at the bottom for their clone URLs. If you use a released version of funbot, you can safely install all the dependencies from Hackage as usual.

This program is free software, and is committed to software freedom. It is released to the public domain using the CC0 Public Domain Dedication. For the boring "legal" details see the file COPYING.

See the file INSTALL.md for a detailed usage and deployment guide. The file ChangeLog explains how to see the history log of the changes done in the code. NEWS.md provides a friendly overview of the changes for each release.

Reporting Bugs and Suggesting Features

If you found a bug, or you have an idea, a feature request or a wishlist item, open a ticket for it! Even if you're goint to implement something or try to solve it.

Use NotABug's issue system.

User/Contributor Guide

There is a detailed guide for running the bot and creating a development setup. It's in the INSTALL.md file.

If you're going to implement some feature or fix some bug you found, start by opening an issue so that other people will know which features are being developed and who does what.