TellerBot

@TellerBot is an asynchronous Telegram Bot written in Python to help you meet people that you can swap money with.

• Python >= 3.8
• MongoDB
• Motor - asynchronous Python driver for MongoDB
• AIOgram - asynchronous Python library for Telegram Bot API
• Emoji - emoji for Python

1. Clone the repository:

git clone https://github.com/fincubator/tellerbot
cd tellerbot

2. Create environment file from example:

cp .env.example .env

3. Personalize settings by modifying .env with your preferable text editor.
4. Create a new Telegram bot by talking to @BotFather and get its API token.
5. Create a file containing Telegram bot's API token with filename specified in TOKEN_FILENAME from .env.
6. Install Docker Compose.
7. Start container:

docker-compose up

1. Clone the repository:

git clone https://github.com/fincubator/tellerbot
cd tellerbot

2. Install Python version no less than 3.8.
3. Install requirements:

pip install -r requirements.txt
pip install -r requirements-escrow.txt  # If you're going to support escrow

4. Create environment file from example:

cp .env.example .env

5. Personalize settings by modifying .env with your preferable text editor. Remove INTERNAL_HOST and DATABASE_HOST if you want bot and database running on localhost.
6. Create a new Telegram bot by talking to @BotFather and get its API token.
7. Create a file containing Telegram bot's API token with filename specified in TOKEN_FILENAME from .env.
8. Install and start MongoDB server.
9. Set environment variables:

export $(grep -v '^#' .env | xargs)

10. Launch TellerBot:

python .

You can help by working on opened issues, fixing bugs, creating new features, improving documentation or translating bot messages to your language.

Before contributing, please read CONTRIBUTING.md first.

TellerBot is released under the GNU Affero General Public License v3.0. See COPYING for the full licensing conditions.