Spaces:
Running
Running
File size: 14,262 Bytes
b9d12d1 d3062ba 1428d20 d3062ba 1428d20 b9d12d1 9277464 1428d20 b9d12d1 d3062ba cf96b21 d3062ba b9d12d1 d3062ba b9d12d1 d3062ba 765659f 099d3ad 765659f b9d12d1 d3062ba b9d12d1 d3062ba b9d12d1 d3062ba b9d12d1 06fe1a1 d3062ba 06fe1a1 b9d12d1 1428d20 b9d12d1 d3062ba b9d12d1 9277464 b9d12d1 6c85d60 b9d12d1 6c85d60 b9d12d1 9277464 b9d12d1 9277464 b9d12d1 9277464 b9d12d1 d3062ba b9d12d1 df5853b baeabbc df5853b b9d12d1 df5853b 765659f b9d12d1 765659f b9d12d1 765659f b9d12d1 765659f b9d12d1 5534b90 b9d12d1 765659f b9d12d1 765659f b9d12d1 765659f b9d12d1 765659f b9d12d1 d3062ba 9277464 d3062ba b9d12d1 d3062ba b9d12d1 1428d20 b9d12d1 d3062ba b9d12d1 d3062ba b9d12d1 d3062ba b9d12d1 1428d20 b9d12d1 d3062ba b9d12d1 d3062ba b9d12d1 bdb63d2 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 | #!/bin/bash
set -euo pipefail
umask 0077
# ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# HuggingMes β Hermes Gateway for HF Spaces
# ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
# ββ Startup Banner ββ
APP_DIR="${HUGGINGMES_APP_DIR:-/opt/huggingmes}"
HERMES_HOME="${HERMES_HOME:-/opt/data}"
PUBLIC_PORT="${PORT:-7861}"
GATEWAY_API_PORT="${API_SERVER_PORT:-8642}"
DASHBOARD_PORT="${DASHBOARD_PORT:-9119}"
TELEGRAM_WEBHOOK_PORT="${TELEGRAM_WEBHOOK_PORT:-8765}"
SYNC_INTERVAL="${SYNC_INTERVAL:-600}"
BACKUP_DATASET="${BACKUP_DATASET_NAME:-huggingmes-backup}"
CF_PROXY_ENV_FILE="/tmp/huggingmes-cloudflare-proxy.env"
export HERMES_HOME
export API_SERVER_ENABLED="${API_SERVER_ENABLED:-true}"
export API_SERVER_HOST="${API_SERVER_HOST:-127.0.0.1}"
export API_SERVER_PORT="$GATEWAY_API_PORT"
export GATEWAY_HEALTH_URL="${GATEWAY_HEALTH_URL:-http://127.0.0.1:${GATEWAY_API_PORT}}"
export TELEGRAM_WEBHOOK_PORT
echo ""
echo " ββββββββββββββββββββββββββββββββββββββββββββ"
echo " β πͺ½ HuggingMes Hermes Gateway β"
echo " ββββββββββββββββββββββββββββββββββββββββββββ"
echo ""
if [ -z "${API_SERVER_KEY:-}" ]; then
if [ -n "${GATEWAY_TOKEN:-}" ]; then
export API_SERVER_KEY="$GATEWAY_TOKEN"
else
API_SERVER_KEY="$(python3 - <<'PY'
import secrets
print(secrets.token_urlsafe(32))
PY
)"
export API_SERVER_KEY
echo "GATEWAY_TOKEN not set - generated an ephemeral API token for this boot."
fi
fi
# ββ Setup directories ββ
mkdir -p "$HERMES_HOME"/{cron,sessions,logs,hooks,memories,skills,skins,plans,workspace,home,plugins}
# Expose hermes CLI in ~/.local/bin so login shells (terminal backend) find it.
# Base image PATH includes /opt/data/.local/bin but hermes lives in the venv.
mkdir -p "$HERMES_HOME/.local/bin"
ln -sfn /opt/hermes/.venv/bin/hermes "$HERMES_HOME/.local/bin/hermes"
# Redirect Hermes plugin dir into volume so plugins survive container restarts
if [ ! -L "${HOME}/.hermes/plugins" ]; then
mkdir -p "${HOME}/.hermes"
rm -rf "${HOME}/.hermes/plugins"
ln -sfn "$HERMES_HOME/plugins" "${HOME}/.hermes/plugins"
fi
# ββ Restore workspace/state from HF Dataset ββ
if [ -n "${HF_TOKEN:-}" ]; then
echo "Restoring Hermes state from HF Dataset..."
python3 "$APP_DIR/hermes-sync.py" restore || true
else
echo "HF_TOKEN not set - dataset persistence is disabled."
fi
CLOUDFLARE_WORKERS_TOKEN="${CLOUDFLARE_WORKERS_TOKEN:-${CLOUDFLARE_API_TOKEN:-}}"
export CLOUDFLARE_WORKERS_TOKEN
if [ -n "${CLOUDFLARE_WORKERS_TOKEN:-}" ] || [ -n "${CLOUDFLARE_PROXY_URL:-}" ]; then
export CLOUDFLARE_PROXY_DEBUG="${CLOUDFLARE_PROXY_DEBUG:-false}"
echo "Preparing Cloudflare Telegram proxy..."
python3 "$APP_DIR/cloudflare-proxy-setup.py" || true
if [ -f "$CF_PROXY_ENV_FILE" ]; then
. "$CF_PROXY_ENV_FILE"
fi
fi
if [ -n "${CLOUDFLARE_WORKERS_TOKEN:-}" ]; then
echo "Preparing Cloudflare Keepalive worker..."
python3 "$APP_DIR/cloudflare-keepalive-setup.py" || true
fi
if [ -n "${TELEGRAM_USER_IDS:-}" ] && [ -z "${TELEGRAM_ALLOWED_USERS:-}" ]; then
export TELEGRAM_ALLOWED_USERS="$TELEGRAM_USER_IDS"
elif [ -n "${TELEGRAM_USER_ID:-}" ] && [ -z "${TELEGRAM_ALLOWED_USERS:-}" ]; then
export TELEGRAM_ALLOWED_USERS="$TELEGRAM_USER_ID"
fi
if [ -n "${TELEGRAM_BOT_TOKEN:-}" ] && [ -n "${SPACE_HOST:-}" ] && [ -z "${TELEGRAM_WEBHOOK_URL:-}" ]; then
if [ "${TELEGRAM_MODE:-webhook}" != "polling" ]; then
export TELEGRAM_WEBHOOK_URL="https://${SPACE_HOST}/telegram"
fi
fi
if [ -n "${TELEGRAM_WEBHOOK_URL:-}" ] && [ -z "${TELEGRAM_WEBHOOK_SECRET:-}" ]; then
SECRET_FILE="$HERMES_HOME/.huggingmes-telegram-webhook-secret"
if [ -f "$SECRET_FILE" ]; then
export TELEGRAM_WEBHOOK_SECRET
TELEGRAM_WEBHOOK_SECRET="$(cat "$SECRET_FILE")"
else
TELEGRAM_WEBHOOK_SECRET="$(python3 - <<'PY'
import secrets
print(secrets.token_hex(32))
PY
)"
printf '%s' "$TELEGRAM_WEBHOOK_SECRET" > "$SECRET_FILE"
chmod 600 "$SECRET_FILE"
export TELEGRAM_WEBHOOK_SECRET
fi
fi
MODEL_INPUT="${HERMES_MODEL:-${LLM_MODEL:-}}"
MODEL_FOR_CONFIG="$MODEL_INPUT"
PROVIDER_FOR_CONFIG="${HERMES_INFERENCE_PROVIDER:-auto}"
LLM_API_KEY="${LLM_API_KEY:-}"
if [ -n "$MODEL_INPUT" ]; then
MODEL_PREFIX="${MODEL_INPUT%%/*}"
else
MODEL_PREFIX=""
fi
case "$MODEL_PREFIX" in
openrouter)
[ -n "$LLM_API_KEY" ] && export OPENROUTER_API_KEY="${OPENROUTER_API_KEY:-$LLM_API_KEY}"
[ "$PROVIDER_FOR_CONFIG" = "auto" ] && PROVIDER_FOR_CONFIG="openrouter"
MODEL_FOR_CONFIG="${MODEL_INPUT#openrouter/}"
;;
huggingface|hf)
[ -n "$LLM_API_KEY" ] && export HF_TOKEN="${HF_TOKEN:-$LLM_API_KEY}"
[ "$PROVIDER_FOR_CONFIG" = "auto" ] && PROVIDER_FOR_CONFIG="huggingface"
MODEL_FOR_CONFIG="${MODEL_INPUT#huggingface/}"
;;
vercel-ai-gateway|ai-gateway)
[ -n "$LLM_API_KEY" ] && export AI_GATEWAY_API_KEY="${AI_GATEWAY_API_KEY:-$LLM_API_KEY}"
[ "$PROVIDER_FOR_CONFIG" = "auto" ] && PROVIDER_FOR_CONFIG="ai-gateway"
MODEL_FOR_CONFIG="${MODEL_INPUT#*/}"
;;
anthropic)
[ -n "$LLM_API_KEY" ] && export ANTHROPIC_API_KEY="${ANTHROPIC_API_KEY:-$LLM_API_KEY}"
;;
openai|openai-codex)
[ -n "$LLM_API_KEY" ] && export OPENAI_API_KEY="${OPENAI_API_KEY:-$LLM_API_KEY}"
;;
google|gemini)
[ -n "$LLM_API_KEY" ] && export GOOGLE_API_KEY="${GOOGLE_API_KEY:-$LLM_API_KEY}" GEMINI_API_KEY="${GEMINI_API_KEY:-$LLM_API_KEY}"
PROVIDER_FOR_CONFIG="gemini"
MODEL_FOR_CONFIG="${MODEL_INPUT#*/}" # strip "google/" or "gemini/" prefix β Hermes gemini provider needs bare model name
;;
deepseek)
[ -n "$LLM_API_KEY" ] && export DEEPSEEK_API_KEY="${DEEPSEEK_API_KEY:-$LLM_API_KEY}"
;;
kimi-coding|moonshot)
[ -n "$LLM_API_KEY" ] && export KIMI_API_KEY="${KIMI_API_KEY:-$LLM_API_KEY}"
;;
kimi-coding-cn|moonshot-cn|kimi-cn)
[ -n "$LLM_API_KEY" ] && export KIMI_CN_API_KEY="${KIMI_CN_API_KEY:-$LLM_API_KEY}"
;;
minimax)
[ -n "$LLM_API_KEY" ] && export MINIMAX_API_KEY="${MINIMAX_API_KEY:-$LLM_API_KEY}"
;;
minimax-cn)
[ -n "$LLM_API_KEY" ] && export MINIMAX_CN_API_KEY="${MINIMAX_CN_API_KEY:-$LLM_API_KEY}"
;;
xiaomi)
[ -n "$LLM_API_KEY" ] && export XIAOMI_API_KEY="${XIAOMI_API_KEY:-$LLM_API_KEY}"
;;
zai|z-ai|z.ai|glm)
[ -n "$LLM_API_KEY" ] && export GLM_API_KEY="${GLM_API_KEY:-$LLM_API_KEY}"
;;
arcee|arcee-ai|arceeai)
[ -n "$LLM_API_KEY" ] && export ARCEEAI_API_KEY="${ARCEEAI_API_KEY:-$LLM_API_KEY}"
;;
gmi|gmi-cloud|gmicloud)
[ -n "$LLM_API_KEY" ] && export GMI_API_KEY="${GMI_API_KEY:-$LLM_API_KEY}"
;;
alibaba)
[ -n "$LLM_API_KEY" ] && export DASHSCOPE_API_KEY="${DASHSCOPE_API_KEY:-$LLM_API_KEY}"
;;
alibaba-coding-plan|alibaba_coding)
[ -n "$LLM_API_KEY" ] && export DASHSCOPE_API_KEY="${DASHSCOPE_API_KEY:-$LLM_API_KEY}"
;;
tencent-tokenhub|tencent|tokenhub|tencentmaas)
[ -n "$LLM_API_KEY" ] && export TOKENHUB_API_KEY="${TOKENHUB_API_KEY:-$LLM_API_KEY}"
;;
nvidia)
[ -n "$LLM_API_KEY" ] && export NVIDIA_API_KEY="${NVIDIA_API_KEY:-$LLM_API_KEY}"
;;
xai|grok)
[ -n "$LLM_API_KEY" ] && export XAI_API_KEY="${XAI_API_KEY:-$LLM_API_KEY}"
;;
kilocode)
[ -n "$LLM_API_KEY" ] && export KILOCODE_API_KEY="${KILOCODE_API_KEY:-$LLM_API_KEY}"
;;
opencode-zen)
[ -n "$LLM_API_KEY" ] && export OPENCODE_ZEN_API_KEY="${OPENCODE_ZEN_API_KEY:-$LLM_API_KEY}"
;;
opencode-go)
[ -n "$LLM_API_KEY" ] && export OPENCODE_GO_API_KEY="${OPENCODE_GO_API_KEY:-$LLM_API_KEY}"
;;
esac
if [ -n "${CUSTOM_BASE_URL:-}" ]; then
PROVIDER_FOR_CONFIG="${CUSTOM_PROVIDER:-custom}"
[ -n "$LLM_API_KEY" ] && export OPENAI_API_KEY="${OPENAI_API_KEY:-$LLM_API_KEY}"
fi
export MODEL_FOR_CONFIG PROVIDER_FOR_CONFIG
export CUSTOM_BASE_URL="${CUSTOM_BASE_URL:-}"
export CUSTOM_API_KEY="${CUSTOM_API_KEY:-${LLM_API_KEY:-}}"
export CUSTOM_MODEL_CONTEXT_LENGTH="${CUSTOM_MODEL_CONTEXT_LENGTH:-131072}"
export CUSTOM_MODEL_MAX_TOKENS="${CUSTOM_MODEL_MAX_TOKENS:-8192}"
export TELEGRAM_BASE_URL="${TELEGRAM_BASE_URL:-}"
export TELEGRAM_BASE_FILE_URL="${TELEGRAM_BASE_FILE_URL:-}"
if [ -n "${CLOUDFLARE_PROXY_URL:-}" ] && [ -z "$TELEGRAM_BASE_URL" ]; then
CLOUDFLARE_PROXY_URL="${CLOUDFLARE_PROXY_URL%/}"
export TELEGRAM_BASE_URL="${CLOUDFLARE_PROXY_URL}/bot"
export TELEGRAM_BASE_FILE_URL="${CLOUDFLARE_PROXY_URL}/file/bot"
fi
# ββ Build config ββ
python3 - <<'PY'
import os
from pathlib import Path
import yaml
home = Path(os.environ["HERMES_HOME"])
path = home / "config.yaml"
try:
config = yaml.safe_load(path.read_text(encoding="utf-8")) or {}
except FileNotFoundError:
config = {}
model_name = os.environ.get("MODEL_FOR_CONFIG", "").strip()
provider_name = os.environ.get("PROVIDER_FOR_CONFIG", "").strip()
if model_name:
model = config.setdefault("model", {})
model["default"] = model_name # always from env β deploy-time setting
if provider_name and provider_name != "auto":
model["provider"] = provider_name # explicit provider (openrouter, huggingface, customβ¦)
else:
model.pop("provider", None) # let Hermes infer from model-name prefix
else:
model = config.get("model", {})
print("No LLM_MODEL/HERMES_MODEL set; leaving Hermes model config unchanged.")
custom_base = os.environ.get("CUSTOM_BASE_URL", "").strip()
if custom_base and model_name:
model.setdefault("base_url", custom_base.rstrip("/"))
if os.environ.get("CUSTOM_API_KEY"):
model.setdefault("api_key", os.environ["CUSTOM_API_KEY"])
try:
model.setdefault("context_length", int(os.environ.get("CUSTOM_MODEL_CONTEXT_LENGTH", "131072")))
model.setdefault("max_tokens", int(os.environ.get("CUSTOM_MODEL_MAX_TOKENS", "8192")))
except ValueError:
pass
config.setdefault("terminal", {}).setdefault("cwd", os.environ.get("MESSAGING_CWD", str(home / "workspace")))
config.setdefault("compression", {}).setdefault("enabled", True)
config.setdefault("display", {}).setdefault("background_process_notifications", os.environ.get("HERMES_BACKGROUND_NOTIFICATIONS", "result"))
config.setdefault("security", {}).setdefault("redact_secrets", True)
platforms = config.setdefault("platforms", {})
if os.environ.get("TELEGRAM_BOT_TOKEN"):
telegram = platforms.setdefault("telegram", {})
telegram.setdefault("enabled", True)
extra = telegram.setdefault("extra", {})
if os.environ.get("TELEGRAM_BASE_URL"):
extra.setdefault("base_url", os.environ["TELEGRAM_BASE_URL"])
extra.setdefault("base_file_url", os.environ.get("TELEGRAM_BASE_FILE_URL") or os.environ["TELEGRAM_BASE_URL"])
if os.environ.get("TELEGRAM_ALLOWED_USERS"):
config.setdefault("telegram", {}).setdefault("allow_from", [
item.strip()
for item in os.environ["TELEGRAM_ALLOWED_USERS"].split(",")
if item.strip()
])
path.write_text(yaml.safe_dump(config, sort_keys=False), encoding="utf-8")
path.chmod(0o600)
PY
# ββ Startup Summary ββ
echo ""
echo "Model : ${MODEL_FOR_CONFIG:-unset}"
echo "Provider : ${PROVIDER_FOR_CONFIG:-unset}"
if [ -n "${TELEGRAM_BOT_TOKEN:-}" ]; then
echo "Telegram : enabled"
else
echo "Telegram : not configured"
fi
if [ -n "${HF_TOKEN:-}" ]; then
echo "Backup : ${BACKUP_DATASET} (every ${SYNC_INTERVAL:-600}s)"
else
echo "Backup : disabled"
fi
if [ -n "${CLOUDFLARE_PROXY_URL:-}" ]; then
echo "Proxy : ${CLOUDFLARE_PROXY_URL}"
fi
echo "Dashboard : http://127.0.0.1:${DASHBOARD_PORT}"
echo "Gateway : http://127.0.0.1:${GATEWAY_API_PORT}"
echo ""
# ββ Trap SIGTERM for graceful shutdown ββ
graceful_shutdown() {
echo "Shutting down HuggingMes..."
if [ -n "${HF_TOKEN:-}" ]; then
python3 "$APP_DIR/hermes-sync.py" sync-once || echo "Warning: shutdown sync failed."
fi
kill $(jobs -p) 2>/dev/null || true
exit 0
}
trap graceful_shutdown SIGTERM SIGINT
# ββ Start background services ββ
node "$APP_DIR/health-server.js" &
HEALTH_PID=$!
if [ -n "${WEBHOOK_URL:-}" ]; then
python3 - <<'PY' >/dev/null 2>&1 &
import json, os, urllib.request
body = json.dumps({
"event": "restart",
"status": "success",
"message": "HuggingMes Hermes gateway has started.",
"model": os.environ.get("MODEL_FOR_CONFIG", ""),
}).encode()
req = urllib.request.Request(os.environ["WEBHOOK_URL"], data=body, method="POST", headers={"Content-Type": "application/json"})
urllib.request.urlopen(req, timeout=10).read()
PY
fi
echo "Launching Hermes dashboard on 127.0.0.1:${DASHBOARD_PORT}..."
(hermes dashboard --host 127.0.0.1 --insecure 2>&1 | tee -a "$HERMES_HOME/logs/dashboard.log") &
DASHBOARD_PID=$!
# ββ Launch gateway ββ
echo "Launching Hermes gateway..."
(hermes gateway run 2>&1 | tee -a "$HERMES_HOME/logs/gateway.log") &
GATEWAY_PID=$!
GATEWAY_READY_TIMEOUT="${GATEWAY_READY_TIMEOUT:-120}"
ready=false
for ((i=0; i<GATEWAY_READY_TIMEOUT; i++)); do
if (echo > "/dev/tcp/127.0.0.1/${GATEWAY_API_PORT}") 2>/dev/null; then
ready=true
break
fi
if ! kill -0 "$GATEWAY_PID" 2>/dev/null; then
break
fi
sleep 1
done
if [ "$ready" != "true" ]; then
echo ""
echo "Hermes gateway failed to expose the API health port. Last 40 log lines:"
echo "----------------------------------------"
tail -40 "$HERMES_HOME/logs/gateway.log" || true
exit 1
fi
if [ -n "${HF_TOKEN:-}" ]; then
python3 -u "$APP_DIR/hermes-sync.py" loop &
fi
wait "$GATEWAY_PID"
# Gateway exited (e.g. user restarted from Hermes UI). Sync before container dies.
# SIGTERM path is handled by graceful_shutdown trap above; this covers natural exit.
if [ -n "${HF_TOKEN:-}" ]; then
echo "Gateway exited β syncing state before shutdown..."
python3 "$APP_DIR/hermes-sync.py" sync-once || echo "Warning: final sync failed."
fi
|