Let's build a bot!

Build apps that can respond to humans and perform automated tasks on their behalf. Botkit is a flexible tool for creating conversational software of all types.

Pre-flight Checklist

Each Botkit bot is actually a Node.js app, made up of the Botkit core library, a basic web server, and the application logic and plugins that combine to make your bot special. To run Botkit, you will need to have Node installed on your computer. If you don't already have it set up, follow the instructions here.

If you don't want to build the bot locally, we suggest remixing one of our starter kits on Glitch. Glitch provides a free place to host and edit your bot in the cloud.

Install Botkit

Use npm to install Botkit. Use the "-g" flag to install it globally, which makes Botkit's command line tool available.

npm install -g botkit

Create your bot

It's time to create a new Botkit app! From your command line, type the following command:

botkit new --platform web

The command line tool will collect a few pieces of information from you, like the name of your bot and various API keys. Then, it will create a pre-configured and ready-to-customize bot project for you.

Installation complete! To start your bot, type:
cd my_project && node .

Boot it up and say Hello!

Next, run the app from the project folder. It'll boot up and you'll be able to chat with the bot in your web browser!

cd my_project
node .

You'll see...

I AM ONLINE! COME TALK TO ME: http://localhost:3000

Your bot is alive!!!!! If you did this on your local computer, you should be able to load it in your browser at http://localhost:3000 and get to chatting!

Upgrade Your Bot's Brain

With your new bot up and running, now comes the fun part - creating a personality for your bot, and adding features to make it useful!

Here's a few ways you can get started: