Nice to meet you! I'm a IRC bot written in Go using go-ircevent for IRC connectivity.

I can be deployed to heroku and used in slack to overpower slackbot.

I'm always hanging out as go-bot in the channel #go-bot @ irc.freenode.org

To see what I can do, type !help in the channel or send me a private message.

• !gif: Posts a random gif url from giphy.com. Try it with: !gif cat
• !catgif: Posts a random cat gif url from thecatapi.com
• !godoc: Searches packages in godoc.org. Try it with: !godoc net/http
• !puppet: Allows you to send messages through the bot: Try it with: !puppet say #go-bot Hello!

Passive commands are triggered by keywords, urls, etc.

These commands differ from the active commands as they are executed for every match in any text. Ex: The Chuck Norris command, replies with a Chuck Norris fact every time the words "chuck" or "norris" are mentioned on a channel.

• url: Detects url and gets it's title (very naive implementation, works sometimes)
• catfacts: Tells a random cat fact based on some cat keywords
• jira: Detects jira issue numbers and posts the url (necessary to configure the JIRA URL)
• chucknorris: Shows a random chuck norris quote every time the word "chuck" is mentioned

I also have some brazilian commands which only makes sense to brazillians:

• megasena: Gera um número da megasena ou mostra o último resultado
• cotacao: Informa a cotação atual do Dólar e Euro
• dilma (passivo): Diz alguma frase da Dilma quando a palavra "dilma" é citada

If you wish to write your own commands, start with the 2 example commands, they are in the example directory.

If you want me to join your channel, send me a private message with:

!join #channel pass

If I'm boring you, just send a !part command in a channel I'm in.

!join and !part does not work on slack (yet), so use the slack commands like /invite and /remove to invite the bot to the desired channels.

To deploy your go-bot to slack, you need to:

• Create a new bot user integration on slack and get your token
• Import the package bot
• Import the commands you would like to use
• Call Bot.RunSlack(token)

Here is a full example reading the slack token from the `SLACK_TOKEN env var:

package main

import (
    "os"

    "github.com/fabioxgn/go-bot"
    _ "github.com/fabioxgn/go-bot/commands/catfacts"
    _ "github.com/fabioxgn/go-bot/commands/catgif"
    _ "github.com/fabioxgn/go-bot/commands/chucknorris"
    // Import all the commands you wish to use
)

func main() {
    bot.RunSlack(os.Getenv("SLACK_TOKEN")
}

To deploy your own go-bot, you need to:

• Import the package bot
• Import the commands you would like to use
• Fill the Config struct
• Call Bot.Run(config)

Here is a full example:

package main
	import (
		"github.com/fabioxgn/go-bot"
		_ "github.com/fabioxgn/go-bot/commands/catfacts"
		_ "github.com/fabioxgn/go-bot/commands/catgif"
		_ "github.com/fabioxgn/go-bot/commands/chucknorris"
		// Import all the commands you wish to use
		"os"
		"strings"
	)

	func main() {
		bot.Run(&bot.Config{
			Server:   os.Getenv("IRC_SERVER"),
			Channels: strings.Split(os.Getenv("IRC_CHANNELS"), ","),
			User:     os.Getenv("IRC_USER"),
			Nick:     os.Getenv("IRC_NICK"),
			Password: os.Getenv("IRC_PASSWORD"),
			UseTLS:   true,
			Debug:    os.Getenv("DEBUG") != "",})
	}

To join channels with passwords just put the password after the channel name separated by a space:

Channels: []string{"#mychannel mypassword", "#go-bot"}

To see an example project on how to deploy it to heroku, please see my own configuration:

• IRC: https://github.com/fabioxgn/go-bot-heroku
• Slack: https://github.com/fabioxgn/go-bot-slack