Skip to main content

A framework for creating stateful chatbots on Django.

Project description


# Botshot chatbot framework

![PyPI](https://img.shields.io/pypi/v/botshot.svg)
![PyPI - Status](https://img.shields.io/pypi/status/botshot.svg)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/botshot.svg)
![GitHub last commit](https://img.shields.io/github/last-commit/botshot/botshot.svg)
![Read the Docs](https://img.shields.io/readthedocs/botshot.svg)
![GitHub](https://img.shields.io/github/license/botshot/botshot.svg)

<!-- ![PyPI - Django Version](https://img.shields.io/pypi/djversions/botshot.svg) -->
<p>
<img src="https://raw.githubusercontent.com/botshot/botshot/devel/docs/images/botshot.png" height="100"/>
</p>


#### Botshot is a Python/Django framework for building stateful chatbots and conversational interfaces.

With Botshot, you can build complex chatbots that remember past conversations.

Botshot can:
- __Receive messages__ from __Messenger__, __Telegram__ or __Amazon Alexa__ (more platforms coming soon)
- __Understand__ these messages using your favorite **NLU** service
- e.g. "Show me the best concert" -> *intent:* recommend, *query:* concert
- __Keep track of the history__ of the conversation *(context)*
- __Move between different states__ of the conversation based on the context
- __Send messages__ and media back to the user
<!-- - It's __language independent__ -->
<!-- - It has a __web chat GUI__ for easy testing -->

## Getting started

Just install the package and run our `bots` init script.
```bash
pip3 install botshot
bots init my-bot
cd my-bot && bots start my-bot
```

That's it! You can now chat with your bot at http://localhost:8000/chat.


You may also want to configure NLU, chat integrations and analytics, see the documentation for details.

## Docs

It's quite easy to get started!

Find out how to make your own bot in the **[Docs](https://botshot.readthedocs.io)**.

Questions? [Join us on Slack!](https://botshot-slackin.herokuapp.com/)

## Authors
- David Příhoda - [prihoda](https://github.com/prihoda)
- Matúš Žilinec - [mzilinec](https://github.com/mzilinec)
- Jakub Drdák - [drdakjak](https://github.com/drdakjak)


## License
This project is dual licensed. You may only use Botshot for open-source projects under the AGPL license. If you'd like to use Botshot for commercial projects, please contact us for a commercial license.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

botshot-0.1.1-py3-none-any.whl (258.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page