> For the complete documentation index, see [llms.txt](https://hermes.convertino.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hermes.convertino.cloud/hermes.md).

# Hermes

## Overview

Hermes is an open-source system designed to automate **message filtering** in **Telegram groups.** Many users are subscribed to multiple groups but rarely read all incoming messages. Hermes addresses this issue by **monitoring** selected groups, **processing** messages in real time, and **notifying** users only when relevant content is detected.

The system utilizes **AI-based classification** models to determine message relevance, considering both general criteria and user-specific preferences. Through **continuous learning** from **user feedback,** Hermes refines its classification model over time, **improving accuracy** in identifying messages of interest.

Hermes is fully **open source**, allowing anyone to install and run it on their own server or machine. 

Its architecture consists of multiple **modular components** all orchestrated via Docker.

### Get Started <a href="#get-started" id="get-started"></a>

To get started with Hermes and understand how it works, here are some useful links.

{% content-ref url="/pages/ov2KnKhcE13p2jgCWu1y" %}
[How to install](/how-to-install.md)
{% endcontent-ref %}

{% content-ref url="/pages/BTO1St0oQ4h8tbtZvmy6" %}
[Project architecture](/project-architecture.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZzLcNR8E7iLnZGTKDGLz" %}
[App main use case](/app-main-use-case.md)
{% endcontent-ref %}