docker/hermes-stack/README.md

Hermes Docker Stack

Self-hosted SearXNG (metasearch) + Camofox (browser) для Hermes Agent.

Структура

hermes-stack/              # ← самодостаточный проект
├── compose/               # Production compose-файлы
│   ├── searxng/           # SearXNG — self-hosted metasearch
│   └── camofox/           # Camofox — anti-detection browser (Firefox)
├── dev/                   # Dev-версии (другие порты)
│   ├── searxng/
│   └── camofox/
├── volumes/               # Persistent volume data
│   ├── searxng/config/    # settings.yml
│   ├── searxng/data/
│   ├── camofox/browser/   # Firefox profiles
│   └── shared/
├── src/camofox/           # Dockerfile для сборки Camofox
├── scripts/manage.sh      # Управление стеком
├── tests/
├── .env                   # Секреты (gitignored)
├── .env.example
├── .gitignore
└── README.md

Порты

Сервис	Prod	Dev
SearXNG	8964	8965
Camofox	9377	9378

Использование

cd hermes-stack
./scripts/manage.sh start     # Запустить
./scripts/manage.sh status    # Статус
./scripts/manage.sh logs      # Логи
./scripts/manage.sh stop      # Остановить
./scripts/manage.sh dev       # Dev-режим

Интеграция с Hermes

В ~/.hermes/.env:

SEARXNG_URL=http://localhost:8964
CAMOFOX_URL=http://localhost:9377

В ~/.hermes/config.yaml:

web:
  search_backend: searxng
browser:
  backend: camofox
  camofox:
    rewrite_loopback_urls: true
    loopback_host_alias: host.docker.internal