README.md

---
title: BFA Hermes Gateway
emoji: 🤖
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
short_description: BFA Telegram bot — Hermes 4 70B via OpenRouter.
---

# BFA Hermes Gateway

Telegram bot webhook receiver. Routes incoming user messages through Hermes 4 70B
(via OpenRouter) and replies with concise BFA-aligned answers.

## Endpoints

- `GET /` — health check
- `POST /webhook` — Telegram update receiver

## Required Space secrets

- `TELEGRAM_BOT_TOKEN` — from @BotFather
- `OPENROUTER_API_KEY` — for the Hermes model call

## Optional Space secrets

- `LLM_MODEL` — defaults to `nousresearch/hermes-4-70b`
- `TELEGRAM_WEBHOOK_SECRET` — if set, requests must carry matching
  `X-Telegram-Bot-Api-Secret-Token` header
- `SYSTEM_PROMPT` — overrides the default BFA system prompt

## Operator

Building Future Assets · operator: Cole · ops email: bfa.empire.os@gmail.com