Learning Path

Hermes Agent can do a lot — CLI assistant, Telegram/Discord bot, task automation, RL training, and more. This page helps you figure out where to start and what to read based on your experience level and what you’re trying to accomplish.

Tip: Start Here If you haven’t installed Hermes Agent yet, begin with the Installation guide and then run through the Quickstart. Everything below assumes you have a working installation.

How to Use This Page

By Experience Level

LevelGoalRecommended ReadingTime Estimate
BeginnerGet up and running, have basic conversations, use built-in toolsInstallationQuickstartCLI UsageConfiguration~1 hour
IntermediateSet up messaging bots, use advanced features like memory, cron jobs, and skillsSessionsMessagingToolsSkillsMemoryCron~2–3 hours
AdvancedBuild custom tools, create skills, train models with RL, contribute to the projectArchitectureAdding ToolsCreating SkillsRL TrainingContributing~4–6 hours

By Use Case

Pick the scenario that matches what you want to do. Each one links you to the relevant docs in the order you should read them.

“I want a CLI coding assistant”

Use Hermes Agent as an interactive terminal assistant for writing, reviewing, and running code.

  1. Installation
  2. Quickstart
  3. CLI Usage
  4. Code Execution
  5. Context Files
  6. Tips & Tricks

Tip Pass files directly into your conversation with context files. Hermes Agent can read, edit, and run code in your projects.

“I want a Telegram/Discord bot”

Deploy Hermes Agent as a bot on your favorite messaging platform.

  1. Installation
  2. Configuration
  3. Messaging Overview
  4. Telegram Setup
  5. Discord Setup
  6. Voice Mode
  7. Use Voice Mode with Hermes
  8. Security

For full project examples, see:

“I want to automate tasks”

Schedule recurring tasks, run batch jobs, or chain agent actions together.

  1. Quickstart
  2. Cron Scheduling
  3. Batch Processing
  4. Delegation
  5. Hooks

Tip Cron jobs let Hermes Agent run tasks on a schedule — daily summaries, periodic checks, automated reports — without you being present.

“I want to build custom tools/skills”

Extend Hermes Agent with your own tools and reusable skill packages.

  1. Tools Overview
  2. Skills Overview
  3. MCP (Model Context Protocol)
  4. Architecture
  5. Adding Tools
  6. Creating Skills

Tip Tools are individual functions the agent can call. Skills are bundles of tools, prompts, and configuration packaged together. Start with tools, graduate to skills.

“I want to train models”

Use reinforcement learning to fine-tune model behavior with Hermes Agent’s built-in RL training pipeline.

  1. Quickstart
  2. Configuration
  3. RL Training
  4. Provider Routing
  5. Architecture

Tip RL training works best when you already understand the basics of how Hermes Agent handles conversations and tool calls. Run through the Beginner path first if you’re new.

“I want to use it as a Python library”

Integrate Hermes Agent into your own Python applications programmatically.

  1. Installation
  2. Quickstart
  3. Python Library Guide
  4. Architecture
  5. Tools
  6. Sessions

Key Features at a Glance

Not sure what’s available? Here’s a quick directory of major features:

FeatureWhat It DoesLink
ToolsBuilt-in tools the agent can call (file I/O, search, shell, etc.)Tools
SkillsInstallable plugin packages that add new capabilitiesSkills
MemoryPersistent memory across sessionsMemory
Context FilesFeed files and directories into conversationsContext Files
MCPConnect to external tool servers via Model Context ProtocolMCP
CronSchedule recurring agent tasksCron
DelegationSpawn sub-agents for parallel workDelegation
Code ExecutionRun Python scripts that call Hermes tools programmaticallyCode Execution
BrowserWeb browsing and scrapingBrowser
HooksEvent-driven callbacks and middlewareHooks
Batch ProcessingProcess multiple inputs in bulkBatch Processing
RL TrainingFine-tune models with reinforcement learningRL Training
Provider RoutingRoute requests across multiple LLM providersProvider Routing

Based on where you are right now:

Tip You don’t need to read everything. Pick the path that matches your goal, follow the links in order, and you’ll be productive quickly. You can always come back to this page to find your next step.