# 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="how-to-install" %}
[how-to-install](https://hermes.convertino.cloud/how-to-install)
{% endcontent-ref %}

{% content-ref url="project-architecture" %}
[project-architecture](https://hermes.convertino.cloud/project-architecture)
{% endcontent-ref %}

{% content-ref url="app-main-use-case" %}
[app-main-use-case](https://hermes.convertino.cloud/app-main-use-case)
{% endcontent-ref %}