Lightweight alert forwarding gateway — receive alerts from Prometheus Alertmanager or custom sources, and broadcast them to Bark and Telegram concurrently.

• 🚀 Multi-channel dispatch — Bark push + Telegram Bot, sent concurrently via thread pool
• 🔗 Alertmanager native webhook — Drop-in compatible with Prometheus Alertmanager
• 📡 Generic alert API — Simple JSON endpoint for custom integrations
• ♻️ Error aggregation — Collects results from all channels before reporting failures
• ⏱️ Configurable timeout — Per-request HTTP timeout with retry and connection pooling
• 🩺 Health check — Built-in /health endpoint for container orchestration
• 🐳 Docker ready — Includes HEALTHCHECK probe, .dockerignore, and slim image

docker run -d -p 8000:8000 \
  -e BARK_KEY=your_bark_key \
  -e TELEGRAM_BOT_TOKEN=your_bot_token \
  -e TELEGRAM_CHAT_ID=your_chat_id \
  --name alerthub \
  alerthub:latest

# Install dependencies
uv sync --dev

# Start dev server
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Health check endpoint.

{"status": "healthy"}

Generic alert endpoint.

curl -X POST http://localhost:8000/alert \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Disk usage > 90%",
    "title": "Disk Alert",
    "level": "critical",
    "url": "https://grafana.example.com/dashboard",
    "group": "infra"
  }'

Prometheus Alertmanager native webhook. Configure in alertmanager.yml:

receivers:
  - name: 'alerthub'
    webhook_configs:
      - url: 'http://alerthub:8000/alertmanager-webhook'

All configuration is done via environment variables:

# Build
docker build -t alerthub .

# Run
docker run -d -p 8000:8000 \
  -e BARK_KEY=your_key \
  -e TELEGRAM_BOT_TOKEN=your_token \
  -e TELEGRAM_CHAT_ID=your_chat_id \
  alerthub

# Install dev dependencies
uv sync --dev

# Run all tests
pytest tests/ -v

MIT