Subscribe Now
Trending News
Shorts

Hermes Stack: self-hosted agent v Dockeru

Hermes Stack: self-hosted agent v Dockeru

Hermes Stack je připravená Docker sestava pro provoz Hermes Agenta na vlastním serveru. Místo ručního skládání kontejneru, konfigurace, persony, skills a paměti dává dohromady konkrétní adresářovou strukturu a compose setup. Hlavní pointa je jednoduchá: agent má běžet jako vzdálená služba, ale jeho data mají zůstat v persistentním HERMES_HOME. Stack vystavuje Hermes API na portu 8642, počítá s použitím přes HTTPS reverse proxy a ukládá konfiguraci, personu, skills, pluginy i memory data do lokálního adresáře ./hermes.

Za projektem stojí Eduard Tomášek, který repozitář publikoval pod účtem eduardtomasek. Samotný stack navazuje na Hermes Agent od Nous Research a přidává konkrétní provozní vrstvu kolem jeho Docker režimu. Oficiální Hermes dokumentace popisuje Docker instalaci jako kontejner s hostovaným adresářem /opt/data, kde žije konfigurace, API klíče, sessions, skills a memories. Hermes Stack tento princip překlápí do vlastního compose řešení, kde je ./hermes na hostiteli mapovaný jako /opt/data uvnitř kontejneru.

K praktickému použití slouží hlavně pro lidi, kteří chtějí provozovat osobního nebo pracovního agenta mimo lokální počítač. Hermes běží v gateway režimu a jeho OpenAI-compatible API se dá volat z klienta, skriptu nebo kompatibilního frontendu. Oficiální API server Hermes podporuje endpoint /v1/chat/completions, endpoint /v1/responses, health check a bearer token přes API_SERVER_KEY. Stack k tomu přidává bezpečnější topologii, ve které se port 8642 typicky nechává lokálně za reverzní proxy a ven jde až HTTPS adresa.

Paměťová část je postavená na memory_tencentdb. V repozitáři je řešená tak, že se nespouští jako samostatná compose služba, ale jako provider uvnitř kontejneru Hermes. Gateway pro paměť nabíhá lazy až při prvním requestu, který paměť skutečně použije, a její interní health endpoint je na 127.0.0.1:8420/health. Data paměti se ukládají do ./hermes/tdai-memory, takže přežijí rebuild i restart kontejneru.

TencentDB Agent Memory je samostatný open-source projekt od Tencent Cloud Database týmu pro dlouhodobou paměť AI agentů. Jeho veřejný popis pracuje s vícevrstvým modelem paměti, kde se odděluje surová konverzace, atomické fakty, agregace podle scénářů a dlouhodobější uživatelský profil. V Hermes Stacku je důležité hlavně to, že tahle paměť není jen externí poznámkový blok, ale runtime provider připojený přímo do Hermes konfigurace. Prakticky to znamená, že agent může mezi sezeními držet preference, předchozí závěry nebo kontext práce bez toho, aby se všechno ručně kopírovalo do promptu.

Z provozního pohledu je zajímavý důraz na opakovatelnost a ladění. Repozitář obsahuje .env.example, docker-compose.yml, vlastní Dockerfile, wrapper entrypoint a šablony pro SOUL.md i skills. Dokumentace v repozitáři řeší také časté chyby kolem vlastnictví souborů, rozdíl mezi aktivní personou v /opt/data/SOUL.md a fallback soubory v image, testování health endpointů i situaci, kdy paměť po startu ještě neodpovídá. To z projektu dělá spíš praktický deployment návod zabalený jako repozitář než obecnou knihovnu.

Zdroje:

Related posts