Hennos

A Telegram chat bot that can use different LLM providers to chat with and respond to user queries.

The live production version of Hennos can be found here on Telegram at Hennos or on the web at Hennos Web.

Technical Specifics

Hennos is built in a few different parts, the main core being a set of Temporal Workflows that make up the behavior of the agent system. The Workflows also handle the different input methods via Signals. The remainder of the core is made up of a set of wrapper Activities around tools, LLM calls, and other common functions that the Workflows can call to perform their tasks.

Outside of the core are different clients that can send signals to the Workflows to interact with the system. Currently supported clients include:

• Telegram
• Discord
• Slack
• Web (via REST API)
• CLI

Running Hennos

Docker Image Build

Build and tag the image locally with the following command:

docker build -t hennos-gpt .

Configure Environment Variables

Copy the .env.dev file to .env and fill in the required environment variables.

Start the Bot in Docker

Start the bot with the following command:

docker compose up

Start the Bot locally (Optional)

If you want to run the bot locally, you can start it with the following command:

npm run dev