Quick Installation and Deployment (Linux/macOS/Windows)
Environment Preparation
- Python 3.10+
- Node.js 18+
- Git
Step 1: Install Prerequisites
First, install the necessary tools:
# Install Git (skip if already installed)
winget install --id Git.Git
Step 2: Clone Repository and Local Installation
Clone the official repository and perform local installation (this is the only viable approach):
# 1. Clone the official repository
git clone https://github.com/NousResearch/Hermes-Agent.git
# 2. Navigate to the directory
cd Hermes-Agent
# 3. Local installation (must use this command)
pip install -e .
✅ Sucessful Installation Indicator: No package not found errors, and the final output shows "Successfully installed hermes-agent-xxx"
Step 3: Post-Installation Initialization
After installation, initialize the system:
# Initialize configuration
hermes setup
hermes gateway setup
# Start the Web panel
hermes start
Strongly recommended to press Enter directly and select option 1 (Quick setup) to get the core functionality running first. You can adjust advanced settings latter using the hermes config command.
| Option | Features | Use Case |
|---|---|---|
| 1. Quick setup (Recommended, default option) | Fast configuration, only sets three core items: model provider, model, and messaging platform, skipping complex advanced settings | Most beginners who want to quickly get running and experiance core functionality |
| 2. Full setup | Complete configuration, includes memory backend, skill library, permission control, scheduled tasks, and all advanced options | Experienced users who need to customize advanced features |
First, get the core functionality working and use hermes chat or the Web panel to experience local conversations. After you're familiar with Hermes usage, add support for platforms like Telegram through the hermes setup gateway command to avoid additional API Token configuration complexity.
✅ Congratulations! Hermes Agent has been successfully installed and configured! You're now at the final step: Do you want to immediately launch the chat interface?
🎉 Congratulations! Your Hermes Agent is running successfully! The CLI interface is now ready. Let's see how to start your first conversation 👇
Key Files and Subsequent Operations
Configuration files are located in the C:\\Users\\SSYB\\.hermes\\ directory, which you can view and modify at any time:
| File / Directory | Purpose |
|---|---|
config.yaml |
Hermes core configuration, including models, memory, and behavior rules |
.env |
Stores your API keys, such as Baidu's DASHSCOPE\_API\_KEY |
cron/, sessions/, logs/ |
Scheduled tasks, conversation sessions, and log files |
Common Subsequent Commands
# Start command-line conversation
hermes
# Start Web interface (http://localhost:7860)
hermes start
# View current configuration
hermes config
# Check if configuration and runtime environment are normal
hermes doctor
# Configuration tools (such as search engines, file operations, etc.)
hermes setup tools
💡 Practical Command Quick Reference
During conversations, you can directly use these slash commands:
/help: View all available commands/memory: View your long-term memory content/skills: View loaded skill list/exit: Exit conversation mode