LibreAI / AI Agents / hermes-agent
// agents · NousResearch/hermes-agent

hermes-agent

The agent that grows with you — a Python framework for adaptive AI agents.

★ 252.0k stars⑂ 54.3k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

hermes-agent is an open-source ai agents project by NousResearch (NousResearch/hermes-agent on GitHub). It has 252,044 GitHub stars and 54,288 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
252,044
Forks
54,288
License
MIT
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Define what you want

    Write down the job you will use the project for before touching any code.

  2. Clone the repository

    Download the source and read the README's setup section first.

  3. Install dependencies

    Run the install steps and add any required API keys or config.

  4. Run the quickstart

    Follow the example in the docs to confirm everything works.

// features

Why people love it

Multi-provider friendly

Topic tags cover Anthropic, Claude, ChatGPT, Claude Code, and Codex ecosystems.

Python-native

Built in Python, the lingua franca of AI tooling.

Adaptive by design

Positioned as an agent that grows with you rather than a fixed automation script.

Open source (MIT)

Permissive MIT licensing for personal and commercial use.

Actively maintained

Pushed in October 2026 with a very large watcher base.

Huge community

Over 54,000 forks signal broad experimentation and third-party extensions.

Advertisement
// run it

Run it yourself

  1. Step 1 — Clone the repo

    Download the source and move into the project folder.

    git clone https://github.com/NousResearch/hermes-agent.git
    cd hermes-agent
  2. Step 2 — Install dependencies

    Create a virtual environment and install the requirements.

    python -m venv .venv && source .venv/bin/activate
    pip install -r requirements.txt
  3. Step 3 — Configure and run

    Add your model API keys per the README, then launch the agent.

    # check README for the exact entry point and config
    python main.py
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains hermes-agent?

It is maintained by Nous Research at NousResearch/hermes-agent, with over 54,000 forks. Check the repo's recent commits and contributor list to gauge current activity.

Is hermes-agent free to use?

Yes. It is released under the MIT license, which permits commercial use, modification, and redistribution. Read the LICENSE file for the exact terms.

Do I need a paid API to use it?

You will need API access to a language model provider (or a local model setup); the agent itself is free. Check the README for the supported providers and how keys are configured.

How is it different from other agent frameworks?

Its stated focus is an agent that "grows with you" — adaptability over time — rather than a fixed tool-calling loop. Compare it against other frameworks in the AI Agents category for your use case.

How do I get started?

Clone the repo, install the Python dependencies, add your model API keys, and follow the README's quickstart. The run steps above give you the general shape.

// keep exploring

Similar tools

AI Agents

agent-framework

A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET.

★ 13.9k starsMIT
View guide →
AI Agents

Openai Agents Python

A lightweight, powerful framework for multi-agent workflows

★ 29.8k starsMIT
View guide →
Agents

griptape

Modular Python framework for AI agents and workflows with tools and memory.

★ 2.6k starsApache-2.0
View guide →
AI Agents

arcade-mcp

A Python framework for building MCP servers and agent tools.

★ 1.0k starsMIT
View guide →
AI Agents

agent-lightning

Microsoft's trainer for AI agents - reinforcement learning for almost any agent framework

★ 18.6k starsMIT
View guide →
AI Agents

NeMo-Agent-Toolkit

NVIDIA's toolkit for connecting, profiling and optimizing teams of AI agents — across any framework

★ 2.7k starsApache-2.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if hermes-agent is not the right fit.

Get hermes-agent

Free and open — grab the source, star the repo, and start creating.