Tweebot_py

Summary

This repository is a tool to create a Twitter bot based on all tweets from a specific user. It handles all the following steps:

Tweets extraction
Language modeling
API deployement
Bot creation

The model behind is a small GPT-2 (124M) inspired by https://github.com/aquadzn/gpt2-french/ It uses the library https://github.com/minimaxir/gpt-2-simple based on Tensorflow

Prerequisites

In order to use this project you should have credentials for a Twitter application created on their dev platform. Then you have to fill the missing fields in .env file (take .env.exemple as template). And finally make sure you are using a python environment.

Basic usage

This repository main goal is to make things simple and you can basically do everything in 4 command lines:

make init
make download {USERNAME}
make train {USERNAME}
make generate {USERNAME}

If the .env file is valid then everything should work

Installation and setup

You can either use Makefile or directly install dependencies by hand

Make:

Just run and you're good:

make init

By hand:

Run:

pip install -r requirements/requirements_runtime.txt

Docker:

This project is encapsulated in a docker container so you should have Docker installed on your environment. For more info check https://docs.docker.com/get-docker/

To build and run the container:

docker build -t tweebot:latest .
docker run --name tweebot --rm --env-file .env -it tweebot

Run tests

To run them just do:

make test

Contact

Nicolas HENRY: nicolas.h@lajavaness.com