Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

This repo is now an archive of the original Botwiki theme for Pico CMS. For the WordPress theme used by the new website see botwiki/botwiki-wp-theme.

Build Status


Note: All members of the team and contributors must read, understand and follow our official Code of Conduct.

Note: If you want to join the official and/or team, read this.

Note: We're looking for volunteer translators!

About is an open-source collection of tutorials, articles, datasets and other resources for creating useful, interesting, artistic and friendly online bots -- smart software agents that do fun or useful stuff -- for Twitter, Slack, IRC and other online networks. also lets you browse these bots by various categories, such as:

and more.

Contributing to Botwiki

Botwiki is powered by Pico (official documentation), which is a very simple CMS running on PHP. It uses the Twig templating language. The content of the site is created with Markdown.

There are a few ways you can contribute to Botwiki.

Reporting issues

If you see an error on any of the pages, you can open a new issue where you describe the problem and if you know, you can also suggest a solution.

Adding a new bot

To add a new bot, you have a few options.

The easiest way is to use the submission form at After filling out the information, your bot will be added to the queue for manual review.

Another option is to send a pull request to this repo.

Things you will need to install and be/get familiar with:

The above will be fine if you want to use a site like to preview your updates. You can use this site to see if your Markdown text looks okay, check if links are working -- but you won't be able to see images.

So, start by cloning the repo:

git clone

All the content is inside the content folder. Let's see how we'd go about adding a new Twitter bot called "my_new_bot"

The structure of the file is very simple, here's an example from the Twitter bot that posts about holidays for each day.

Title: @holidaybot4000
Description: Every day IS a holiday
Author: Stefan Bohacek
Date: July 21, 2015
Tags: twitter,twitterbot,active,node.js,nodejs,node,holidays,images,flags,useful,fourtonfish

Nav: hidden
Robots: index,follow


[@holidaybot4000]( is a Twitter bot that tweets holidays around the world for the given day, typically together with an image of the country's flag. It was created by [@fourtonfish](

The Title should be the name of the bot. I include the "@" for bots on Twitter. The Description should be short and it shows up on the search page or when you browse the content of the site by tags.

The Author should be your name (or Twitter handle, or your stage name), as the author of the page. (Although, I don't think this shows up anywhere right now.)

Date will be today's date. It should also be updated in case you're doing a major change to an existing page.

I recommend as many useful tags as possible. You can browse the website or open some of the files to see what some common tags are, but be sure to include whether the bot is active or inactive, some basic keywords, for example images if the bot posts or handles images in any way, and if the bot has publicly available source code, be sure to include the open source and opensource tags. (This is necessary due to the limitations of the search feature.)

You can keep the Nav and Robots values as they are. Nav: hidden just means that the bot won't show up in the main navigation, like the About, Bots, Tutorials, etc pages.

Now, you will also need to go to your bot's page and take a screenshot that shows how the bot works. There is no set requirement for the height, since every bot may need different amount of space to show what it does, but the width should be 900px.

The screenshot must be in the .png format and also needs to match the name of the bot used for the page Title. If you have spaces in your Title, change them to _ in the image file name.

The screenshot itself should be in the images folder inside the folder where you added your bot. I also recommend downloading a program like ImageOptim (OSX) or Trimage (Linux, Windows, OSX) to optimize the size of the image.

You can then use to check if the content of your .md file renders correctly. If everything looks good, go ahead and open a pull request so that your updates can be reviewed and merged.

Adding a new bot with Botwiki running on your computer

If you prefer to run the site on your computer, you will also need:

After cloning the project:

curl -sS | php
php composer.phar install

Make sure everything installs correctly, otherwise you will see an error that looks like this:

Class 'ParsedownExtra' not found in /home/stefan/Desktop/Untitled Folder/ on line 152

To run the site on our local machine:

php -S localhost:5000

Tip: You can also create an alias for this command, so that you can execute it in an easier way.

Just type nano ~/.bash_profile in your command line, then add the line below:

alias phpserver='php -S localhost:5000'

Hit ctrl + X to close the document, save it. Finally, run source ~/.bash_profile. Now you can just open the folder and run phpserver in your terminal.

How neat is that!

Note: The port number, which is 5000 here, can be pretty much any number.

Then, we will go to the content/bots/twitterbots folder. We can make a copy of one of the files and rename it to

Once you're done, you will be able to go to localhost:5000/bots/twitterbots/my_new_bot and see your newly added bot.

Updating the website's style

If you want to mess with the look of the site, you will need to also install node (which comes with npm).

Then, from the root directory, you can run:

npm install

First run the site as above:

php -S localhost:5000

And then (in a new terminal window) run the gulp tasks, simply with:

npm start

or if you have gulp installed globally:


The site will be available with live-reloading at http://localhost:3000.

If you for some reason get an error about a node package missing, just install it with

npm install NAME_OF_THE_PACKAGE --save-dev

Contributing without GitHub

If you'd like to contribute outside of GitHub, you can send an email to Simply copy the content of this file and replace it with relevant information.

If you have any questions, feel free to reach out to me using the email above or on Twitter.


Tutorials, articles, datasets and other resources for creating useful, interesting, artistic and friendly online bots.




Unknown, MIT licenses found

Licenses found






No releases published


No packages published