A simple chat bot connecting Instant Messaging and Translation APIs

Guide to Getting Started

You can either use the precompiled packages, compile BabelBot yourself or use the provided Dockerfile.
You can also deploy BabelBot on a Kubernetes cluster using Helm.

1. Grab the latest precompiled release for your platform
2. Configure
3. Run BabelBot.Worker / BabelBot.Worker.exe

1. Make sure you have all prerequisites installed.
2. Download and extract an archive of your desired version (or development branch), or git clone the repository into a path of your choice.
3. Run dotnet publish -c Release to build a release version for your currently used .NET runtime. See the .NET Core documentation for more details on how to use the dotnet CLI utility.
4. Configure
5. Run

A (possibly incomplete, please report if you had to install more) list of prerequisites:

• .NET Core 6.0 SDK

1. Make sure you have all prerequisites installed.
2. Download and extract an archive of your desired version (or development branch), or git clone the repository into a path of your choice.
3. Build an image: docker build -t babelbot:local .
   1. You can freely choose the image name and tag.
4. Run BabelBot in Docker: docker run -e Telegram__ApiKey='<api key>' -e Telegram__AllowedUsers__1='<id>' -e DeepL__AuthKey='<auth key>' babelbot:local

• Docker v20+

1. Make sure you have all prerequisites installed.
2. Download and extract an archive of your desired version (or development branch), or git clone the repository into a path of your choice.
3. Create a babelbot-values.yaml (details about which values to provide)
4. Run the following command: helm upgrade --install -n babelbot --create-namespace babelbot ./helm -f ./babelbot-values.yaml

• Helm v3

BabelBot uses the configuration facilities provided by .NET Core.

This means configuration can be applied in different ways:

• Changing the values inside appsettings.json
• Setting environment variables (useful for cloud deployments)
• Using user secrets (only during development)

The required configuration values are documented in the table below.

Some of the configuration parameters are arrays. You can set those with environment variables using the following syntax:

Example

Telegram__AllowedUsers__1=4711
Telegram__AllowedUsers__2=420420

As long as the program is running in the Development environment, you can use the Secret Manager built into dotnet.

Set your API tokens (and other options) with the dotnet command, like this:

dotnet user-secrets set "DeepL:AuthKey" "1234-5678"

They will persist through checkouts and are applied after appsettings.json and environment variables.

• DeepL API Signup - Sign up for DeepL API access here
• DeepL API Docs - Here you can find a list of target language codes supported by DeepL
• Telegram Botfather - Register your Telegram bot here

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

Please adhere to this project's code of conduct.

Massive thanks to (amongst many more) the following projects for making this possible:

• Telegram.Bot for providing a really nice MIT-licensed API library for .NET
• DeepL for creating a fantastic translation service and providing a .NET library for it

This software is provided without warranty or implicit or explicit support.

If you believe you have found an issue (very likely), please issue a bug report as detailed in the contribution guidelines.

In very serious cases, you can send a mail to babelbot@kaputty.de and I'll try to get back to you.

Please note that I do not provide support for misconfigurations or missing installed dependencies.

MIT