✦ 100% client-side — tokens never leave your browser

Deploy in one click

This wizard creates your repo, encrypts and sets every secret, launches GitHub Actions and stays with you until your Space is green. Everything runs locally in your browser.

1
GitHub access
2
Hugging Face
3
Telegram bot
4
Keys & passwords
5
Deploy

🔑 GitHub access

You need a Personal Access Token with repo and workflow scopes so the wizard can create your repo and set its secrets.

1

Open this pre-filled link — the token creation page opens with the right boxes ticked. Give it a name, pick an expiration, then click Generate token.

2

Copy the token (ghp_…) and paste it below. It stays in your browser only.

🔒 This wizard is a static file; tokens are sent only to api.github.com, huggingface.co and api.telegram.org — nowhere else. When the deploy finishes, revoke/rotate this token on GitHub (good hygiene).

🤗 Hugging Face token

A token with the write role is needed to create the Space, upload files and set the Space secrets.

1

In token settings, create a new token with the Write role (or a fine-grained token with Write access to Contents).

Your app's final address will look like this: https://USER-hermes-stack.hf.space

💬 Telegram bot

In Telegram, open @BotFather, send /newbot, and paste the token (123456:AA…) here. You can also skip this step entirely.

For “Fetch from chats”: first send /start to your bot in Telegram (or any message), then click the button — the wizard lists recent senders; click one to allow them. This locks the bot so only you can use it.

🔐 Keys & passwords

Strong values are generated automatically — regenerate any of them or type your own. Everything is stored as an encrypted secret later.

Agent dashboard username
Agent dashboard password
Agent API key (web-to-api)
Router API key
Router first-login password
Keyless-models router key
Keyless-models admin password
⚙️ Advanced settings (optional)
💡 You can change the default model later: edit the HERMES_MODEL variable in Space settings and restart. Exact model ids are listed in the router dashboard (Models tab).

🚀 Ready to deploy

Final checklist — if everything looks right, press the button and relax; the rest is automatic.

deploy — hermes-stack
🎉

Deployment complete — your Space is live!

Everything is ready. Keep these links:

📌 Last 3 steps (2 minutes)

    Open your Space ↗