---

---

Hermes Agent ☤

---

Table of Contents

• What is Hermes Agent?
• Features
• Quick Start
• Installation
• Usage Examples
• System Requirements
• Documentation
• Community & Support
• Contributing
• License

---

What is Hermes Agent?

Hermes Agent is not just another AI chatbot. It's an AI agent that runs in your terminal and can actually do things on your computer.

While traditional chatbots only generate text, Hermes can:

Chatbot	Hermes Agent
❌ Only talks	✅ Takes action
❌ Can't access your files	✅ Reads & writes files
❌ Generic responses	✅ Context-aware tasks
❌ No memory of actions	✅ Makes changes permanent

Think of Hermes as: A helpful AI assistant living in your terminal, ready to automate tasks, organize files, write code, and more — all through natural conversation.

---

Features

Core Capabilities

• File Operations — Create, read, edit, delete, and organize files
• Command Execution — Run terminal commands safely and efficiently
• Search & Analysis — Search files, analyze content, extract information
• Content Creation — Write documents, code, emails, reports
• Automation — Break complex tasks into automated workflows
• Web Integration — Search the web, fetch URLs, extract content
• Data Processing — Work with CSV, JSON, and structured data
• Tool Usage — Access to 15+ built-in tools and actions

What Makes Hermes Special?

Feature	Benefit
Terminal-Native	No GUI overhead, works everywhere
Tool-Enabled	Actually executes tasks, not just talks
Memory-Persistent	Remembers context across sessions
Multi-Model	Choose from various AI models
Privacy-First	Conversations stored locally
Cross-Platform	macOS, Windows (WSL), Linux

---

Quick Start

One-Line Installation

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Get Started in 3 Steps

1. Install — Run the command above
2. Login — Run hermes login and complete signup
3. Start — Run hermes and start chatting!

First Command

Try this after installation:

Create a to-do list for today and save it as todo.txt on my desktop.

---

Installation

Supported Platforms

Platform	Status
macOS (11.0+)	✅ Supported
Windows 10/11 (WSL2)	✅ Supported
Ubuntu 20.04+	✅ Supported
Debian 10+	✅ Supported
Fedora 33+	✅ Supported

Prerequisites

• Python 3.8+
• Git
• curl
• Internet connection

Detailed Installation

macOS

# Install Xcode command line tools
xcode-select --install

# Install Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# Load configuration
source ~/.zshrc

# Login
hermes login

Windows (WSL)

# First, install WSL (run in PowerShell as Admin)
wsl --install

# Then in Ubuntu terminal:
sudo apt update && sudo apt install -y git curl

# Install Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# Load configuration
source ~/.bashrc

# Login
hermes login

Linux

# Install dependencies
sudo apt update && sudo apt install -y git curl

# Install Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# Load configuration
source ~/.bashrc

# Login
hermes login

Promo Code

Use code HERMESAGENT during signup for $10 in free credits!

---

Usage Examples

File Management

Organize my Downloads folder by file type
Create a README.md for my project
Convert all PNG images in this folder to JPG

Coding Assistance

Review this Python code and suggest improvements
Debug why my script is failing
Create a Flask API with 3 endpoints

Research & Analysis

Summarize the key points from this article URL
Analyze this CSV and create a summary report
Research the latest trends in AI agents

Automation

Set up a daily backup script for my Documents
Create a cron job that runs every morning
Generate weekly reports from my data folder

Personal Productivity

Create a weekly meal plan
Plan my work schedule for next week
Write a professional email to my team

---

System Requirements

Minimum

Component	Requirement
RAM	4 GB
CPU	Dual-core (2015+)
Disk	500 MB free
OS	macOS 11+, Windows 10+, Ubuntu 20.04+

Recommended

Component	Requirement
RAM	8 GB+
CPU	Quad-core
Disk	1 GB+ free
Internet	Broadband connection

---

Documentation

Available Guides

Guide	Description
Setup Guide (EN)	Complete English installation guide
Kurulum Rehberi (TR)	Turkish installation guide

Command Reference

Command	Description
hermes	Start the agent
hermes login	Authenticate your account
hermes config --show	View configuration
hermes update	Update to latest version
hermes usage --show	Check usage statistics
hermes logs --tail 100	View recent logs

Configuration

Edit ~/.config/hermes/config.yaml to customize:

• Default AI model
• Working directory
• API timeouts
• Verbosity level
• Proxy settings

---

Community & Support

Join the Community

Platform	Link
Discord	https://discord.gg/nousresearch
Twitter/X	https://twitter.com/NousResearch
GitHub	https://github.com/NousResearch
Website	https://nousresearch.com

Getting Help

1. Read the documentation — Most questions are answered here
2. Search GitHub Issues — Your problem may already be solved
3. Ask on Discord — Active community support
4. Open an Issue — Report bugs or request features

---

Contributing

We welcome contributions! Here's how you can help:

Ways to Contribute

• Report bugs — Open an issue with details
• Suggest features — Share your ideas on Discord
• Improve docs — Fix typos, add examples
• Submit PRs — Code contributions welcome
• Translate — Help localize for your language

Development Setup

# Clone the repository
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Install in development mode
pip install -e .

# Run tests
pytest tests/

Code of Conduct

Please be respectful and inclusive in all community interactions. We're building a welcoming space for everyone.

---

License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Acknowledgments

• Built by: Nous Research
• Powered by: State-of-the-art AI models

---

Project Stats

Metric	Value
Total Funding	$70M+
GitHub Stars	Growing rapidly
Discord Members	Active community
Models Available	Multiple options

---

Roadmap

Coming Soon

• Custom API key support
• Mobile companion app
• Plugin ecosystem
• Offline mode capabilities
• Multi-agent collaboration
• Voice interaction
• Enhanced security features

---

Stay Updated

• Star this repo — Get release notifications
• Follow @NousResearch — Latest news & updates
• Join Discord — Community discussions & announcements
• Newsletter — Subscribe on our website

---

Made with ❤️ by Nous Research

Website | Docs | Discord | Twitter

If you find this project useful, please star it and support the community!

"The future of AI is not just talking — it's doing."