yousufkidiya17/hermes-mobile-modified/hermes-headless-agent-deploy
Claude Code and agent skill by yousufkidiya17/hermes-mobile-modified
- community
Checking that the SKILL.md file is still in the repository.
Deploy Hermes on a headless VM with Telegram + free models.
Install
npx vskill@latest install yousufkidiya17/hermes-mobile-modified/hermes-headless-agent-deploySKILL.md
The same SKILL.md was published earlier as yousufkidiya17/hermes-mobile-modified/hermes-headless-agent-deploy.
Hermes Headless Agent Deploy
Deploy Hermes Agent as a 24/7 headless autonomous agent on a cloud VM with:
- Telegram bot for user interaction
- LocalBridge proxy for free AI models (DeepSeek, Mimo, Nemotron via OpenCode)
- Cron scheduler for autonomous tasks
- systemd service for auto-restart
The VM runs independently — no dependency on the user's local Hermes.
Architecture
Prerequisites
- Cloud VM (e2-micro minimum, e2-small recommended, Ubuntu 24.04)
- Telegram bot token from @BotFather
- OpenCode Zen API free models
Step 1: Create VM
Zone fallbacks: us-west1-a, europe-west1-b, us-central1-f.
Step 2: SSH (Windows Space in Username)
Step 3: Install Hermes
Step 4: Deploy LocalBridge
On VM: mkdir -p ~/LocalBridge && cd ~/LocalBridge && npm init -y && npm install express turndown htmlparser2
Copy server.mjs from local machine via scp, then start:
Step 5: Configure Hermes
Write ~/.hermes/config.yaml:
- model.default:
opencode/mimo-v2.5-free - provider:
custom, base_url:http://localhost:4000/v1 - api_key:
aetherix-master-7x9k2m4p - reasoning_effort:
ultra - gateway.platforms.telegram.enabled: true
- model_aliases for deepseek, mimo, nemotron (each with same base_url/key)
Step 6: Telegram Bot
User sends first message to bot to pair.
Step 7: Cron Jobs
Troubleshooting
Telegram stuck on "attempt 1/8": Clear old sessions:
Systemd reset loop:
Config overwritten: After gateway migration, verify model.default and base_url.
User preferences: Hinglish, casual, concise. CRITICAL: Always explain the plan first, then ask permission before acting. The user corrected the agent multiple times in Session 2026-07-29: must describe → ask → wait for approval → execute. Never jump into actions without the user saying yes.
Reference:references/gcp-vm-setup-tricks.md— Node.js fetch vs curl on GCP, systemd user services, GitHub device-code auth, Telegram adapter stuck-on-attempt-1/8 fix, config overwrite recovery.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingapp/src/main/python/skills/hermes-headless-agent-deploy/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/yousufkidiya17/hermes-mobile-modified/hermes-headless-agent-deploy)