Hermes Handbook

A living, bilingual field guide for running Hermes as a reliable personal AI system.

Hermes is documented here as it is installed, used, tested, and improved. English is the default language at hermes.skywirex.com; the Vietnamese edition is available from the language switcher.

What This Handbook Covers

• Provisioning a small Linux server and securing remote access.
• Installing Hermes, connecting models, and choosing the right interface.
• Designing safe gateways, context files, tools, memory, and reusable skills.
• Automating research, development, content, business, and monitoring workflows.
• Recording decisions and turning repeated work into better procedures.

How To Read It

Start with VPS and Installation, then configure Security and Context. The remaining sections are reference material: read them when a workflow requires them and update them with verified notes.

Each topic should eventually contain four things: the purpose, a tested procedure, failure modes, and the date or source of the latest verification. Unverified assumptions belong in notes, not in operational commands.

Documentation Status

This is a working handbook, not a finished product. Empty or short topics are intentional starting points for the learning journey. The Improvement Loop records how knowledge becomes reusable practice.

Contents

📂 HERMES
┃
┣ 📂 VPS
┃ ┣ 📂 Small Linux Server
┃ ┣ 📂 Dedicated User
┃ ┣ 📂 SSH Access
┃ ┣ 📂 Firewall
┃ ┣ 📂 Tailscale
┃ ┗ 📂 Backups
┃
┣ 📂 Installation
┃ ┣ 📂 Official Installer
┃ ┣ 📂 Python and Dependencies
┃ ┣ 📂 Hermes Doctor
┃ ┣ 📂 Updates
┃ ┗ 📂 Systemd Service
┃
┣ 📂 Models
┃ ┣ 📂 Nous Portal
┃ ┣ 📂 OpenAI Codex
┃ ┣ 📂 Anthropic
┃ ┣ 📂 OpenRouter
┃ ┣ 📂 Local Models
┃ ┗ 📂 On-the-Fly Switching
┃
┣ 📂 Interfaces
┃ ┣ 📂 Terminal
┃ ┣ 📂 TUI
┃ ┣ 📂 Desktop Application
┃ ┣ 📂 Web Dashboard
┃ ┣ 📂 IDE via ACP
┃ ┗ 📂 OpenAI-Compatible API
┃
┣ 📂 Gateway
┃ ┣ 📂 Discord
┃ ┣ 📂 Telegram
┃ ┣ 📂 Slack
┃ ┣ 📂 WhatsApp
┃ ┣ 📂 Email
┃ ┗ 📂 20+ Platforms
┃
┣ 📂 Security
┃ ┣ 📂 Authorized Users
┃ ┣ 📂 DM / Code Pairing
┃ ┣ 📂 Validation of Dangerous Commands
┃ ┣ 📂 Protection of Sensitive Files
┃ ┣ 📂 Docker or SSH Isolation
┃ ┗ 📂 Blocking of Irreversible Commands
┃
┣ 📂 Context
┃ ┣ 📂 SOUL.md
┃ ┣ 📂 AGENTS.md
┃ ┣ 📂 Project Rules
┃ ┗ 📂 Channel-Specific Context
┃
┣ 📂 Tools
┃ ┣ 📂 Terminal
┃ ┣ 📂 File Reading and Writing
┃ ┣ 📂 Web Search
┃ ┣ 📂 Web Browsing
┃ ┣ 📂 Vision
┃ ┣ 📂 Image Generation
┃ ┗ 📂 Speech Synthesis
┃
┣ 📂 Memory
┃ ┣ 📂 User Profile (USER.md)
┃ ┣ 📂 Work Conventions (MEMORY.md)
┃ ┣ 📂 Technical Environment
┃ ┣ 📂 Inter-Session Reminders
┃ ┗ 📂 Search in Past Conversations (session_search)
┃
┣ 📂 Skills
┃ ┣ 📂 Reusable Procedures
┃ ┣ 📂 Community Catalog
┃ ┣ 📂 Slash Commands
┃ ┣ 📂 Custom Skills
┃ ┣ 📂 Improvement During Use
┃ ┗ 📂 Auto-Archiving (Curator)
┃
┣ 📂 Integrations
┃ ┣ 📂 MCP Servers
┃ ┣ 📂 GitHub
┃ ┣ 📂 Databases
┃ ┣ 📂 SaaS Tools
┃ ┣ 📂 Home Assistant
┃ ┗ 📂 Custom Plugins
┃
┣ 📂 Automation
┃ ┣ 📂 Scheduled Tasks
┃ ┣ 📂 Crons with Skills
┃ ┣ 📂 Webhooks
┃ ┣ 📂 Scripts without LLM
┃ ┣ 📂 Multiplatform Delivery
┃ ┗ 📂 Alerts Only If Necessary
┃
┣ 📂 Delegation
┃ ┣ 📂 Isolated Sub-Agents
┃ ┣ 📂 Parallel Work
┃ ┣ 📂 Multi-Agent Board (Kanban)
┃ ┣ 📂 Background Sessions
┃ ┣ 📂 Multi-Step Pipelines
┃ ┗ 📂 Automatic Result Feedback
┃
┣ 📂 Research
┃ ┣ 📂 Automatic Monitoring
┃ ┣ 📂 Multi-Source Search
┃ ┣ 📂 Competitor Analysis
┃ ┣ 📂 Document Synthesis
┃ ┗ 📂 Sourced Reports
┃
┣ 📂 Development
┃ ┣ 📂 Repository Inspection
┃ ┣ 📂 Feature Creation
┃ ┣ 📂 Bug Fixes
┃ ┣ 📂 Tests and Lint
┃ ┣ 📂 Pull Requests
┃ ┗ 📂 Code Review
┃
┣ 📂 Content
┃ ┣ 📂 Idea Research
┃ ┣ 📂 Writing
┃ ┣ 📂 Newsletters
┃ ┣ 📂 Social Networks
┃ ┣ 📂 Images
┃ ┗ 📂 Audio
┃
┣ 📂 Business
┃ ┣ 📂 Email Sorting
┃ ┣ 📂 Meeting Minutes
┃ ┣ 📂 CRM Updates
┃ ┣ 📂 KPI Reports
┃ ┣ 📂 Data Analysis
┃ ┗ 📂 Document Preparation
┃
┣ 📂 Monitoring
┃ ┣ 📂 Server Status
┃ ┣ 📂 Site Changes
┃ ┣ 📂 News
┃ ┣ 📂 Prices
┃ ┣ 📂 Logs
┃ ┗ 📂 Alerts in Discord
┃
┣ 📂 Daily Use
┃ ┣ 📂 Messages from Phone
┃ ┣ 📂 Work While PC Is Off
┃ ┣ 📂 Session Resumption
┃ ┣ 📂 Multiple Profiles (Bots/Personas)
┃ ┣ 📂 Corrections in Progress
┃ ┣ 📂 Results Delivered to the Right Channel
┃ ┗ 📂 Human Validation Before Sensitive Actions
┃
┗ 📂 Improvement Loop
┣ 📂 Memorize What Matters
┣ 📂 Retrieve Past Decisions
┣ 📂 Turn a Method into a Skill
┣ 📂 Reuse the Skill
┣ 📂 Improve It with Each Use
┗ 📂 Learning Journey (/journey)