Some of the suggested commands that follow may require root privileges on your system.
- Python 2.7
Postgresql with hStore extension¶
- OS X:
- Homebrew: installed by default
- Postgres.app: installed by default
apt-get install postgresql-contrib-9.1 postgresql-server-dev-9.1 python-dev virtualenv
Version 1.2 or higher required
- OS X:
brew install go
apt-get install golang-go
- OS X:
brew install redis
apt-get install redis-server
Run in a terminal:
virtualenv botbot && source botbot/bin/activate pip install -e git+https://github.com/BotBotMe/botbot-web.git#egg=botbot cd $VIRTUAL_ENV/src/botbot # This builds the project environment and will run for at least several minutes make dependencies # Adjust ``.env`` file if necessary. Defaults are chosen for local debug environments. # If your Postgres server requires a password, you'll need to override STORAGE_URL # The default database name is 'botbot' $EDITOR .env # Make the variables available to subprocesses export $(cat .env | grep -v ^# | xargs) createdb botbot echo "create extension hstore" | psql botbot manage.py migrate # You'll need a staff account for creating a bot and registering channels manage.py createsuperuser
Redis needs to be running prior to starting the BotBot services. For example:
Then, to run all the services defined in
foreman will also work if you have the gem or Heroku toolbelt installed.
You should now be able to access the site at
http://localhost:8000. Log in with the username you created.
See Getting Started for instructions on configuring a bot.
If you plan make code changes, please read through the Developing with BotBot doc.
If you plan to run BotBot in a production environment please read the Serving BotBot In a Production Environment doc.
The tests can currently be run with the following command:
manage.py test accounts bots logs plugins