# Async Hermes Agent > A native-async, library-focused distribution of Hermes Agent for services, tool-using agents, persistent sessions, and trajectory generation. Install: `uv pip install "git+https://github.com/ykoh42/async-hermes-agent.git"` Repository: https://github.com/ykoh42/async-hermes-agent Documentation: https://ykoh42.github.io/async-hermes-agent/ ## Overview - [Async Hermes Agent Documentation](https://ykoh42.github.io/async-hermes-agent/): An async-only Python library port of the retained Hermes Agent harness. ## Getting Started - [Installation](https://ykoh42.github.io/async-hermes-agent/getting-started/installation): Install Async Hermes Agent, verify the async API, and add only the provider dependencies you need. - [Learning Path](https://ykoh42.github.io/async-hermes-agent/getting-started/learning-path): Choose a documentation path for embedding, serving, or generating training trajectories with Async Hermes Agent. - [Platform Support](https://ykoh42.github.io/async-hermes-agent/getting-started/platform-support): Supported Python versions, operating systems, and installation methods for Async Hermes Agent. - [Quickstart](https://ykoh42.github.io/async-hermes-agent/getting-started/quickstart): Choose any supported provider and run your first awaited Hermes Agent conversation. - [Updating & Uninstalling](https://ykoh42.github.io/async-hermes-agent/getting-started/updating): Move between Async Hermes Agent releases while keeping application state and source changes explicit. ## User Guide - [Configuration](https://ykoh42.github.io/async-hermes-agent/user-guide/configuration): Configure the native-async library without relying on a setup CLI. - [Configuring Models](https://ykoh42.github.io/async-hermes-agent/user-guide/configuring-models): Select provider, model, credentials, and reasoning settings for an async agent. - [Batch Processing](https://ykoh42.github.io/async-hermes-agent/user-guide/features/batch-processing): Generate ordered tool-use trajectories with bounded async concurrency and resumable JSONL output. - [Browser Automation](https://ykoh42.github.io/async-hermes-agent/user-guide/features/browser): Use local Chromium, an existing CDP endpoint, or retained cloud browser plugins. - [LSP — Semantic Diagnostics](https://ykoh42.github.io/async-hermes-agent/user-guide/features/lsp): Real language servers (pyright, gopls, rust-analyzer, …) wired into the post-write lint check used by write_file and patch. - [MCP](https://ykoh42.github.io/async-hermes-agent/user-guide/features/mcp): Extend the tool surface through native-async Model Context Protocol clients. - [Memory](https://ykoh42.github.io/async-hermes-agent/user-guide/features/memory): Use bounded file-backed memory, user profiles, and optional async memory providers. - [Feature Overview](https://ykoh42.github.io/async-hermes-agent/user-guide/features/overview): What the native-async Hermes library retains and what applications must provide. - [Skills](https://ykoh42.github.io/async-hermes-agent/user-guide/features/skills): Add reusable procedural knowledge without growing the core tool schema. - [Tools and Toolsets](https://ykoh42.github.io/async-hermes-agent/user-guide/features/tools): Select and execute the retained native-async tool surface. - [Security](https://ykoh42.github.io/async-hermes-agent/user-guide/security): Operate the async agent harness with least-privilege tools, credentials, and integrations. - [Sessions](https://ykoh42.github.io/async-hermes-agent/user-guide/sessions): Preserve and resume ordered conversations with awaitable SQLite or PostgreSQL SessionDB. ## Integrations - [Integrations](https://ykoh42.github.io/async-hermes-agent/integrations): Extend the native-async harness through providers, plugins, MCP, and skills. - [Model Providers](https://ykoh42.github.io/async-hermes-agent/integrations/providers): Select a native-async model transport and install only its required dependencies. ## Guides - [Python Library](https://ykoh42.github.io/async-hermes-agent/guides/python-library): Embed the native-async Hermes agent loop in an asyncio application. - [Use MCP with Hermes](https://ykoh42.github.io/async-hermes-agent/guides/use-mcp-with-hermes): Connect stdio or HTTP MCP servers to the native-async agent lifecycle. - [Work with Skills](https://ykoh42.github.io/async-hermes-agent/guides/work-with-skills): Create, discover, and load reusable skill documents in the async agent harness. ## Developer Guide - [Agent Loop Internals](https://ykoh42.github.io/async-hermes-agent/developer-guide/agent-loop): Awaited turn setup, model/tool iteration, cancellation, persistence, and finalization - [Architecture](https://ykoh42.github.io/async-hermes-agent/developer-guide/architecture): Native-async library architecture, retained subsystem boundaries, and execution flow - [Programmatic Integration](https://ykoh42.github.io/async-hermes-agent/developer-guide/programmatic-integration): Embed AIAgent in an existing asyncio application and manage its lifecycle safely - [Session Storage](https://ykoh42.github.io/async-hermes-agent/developer-guide/session-storage): Awaitable SQLite session persistence, search, lineage, and ownership - [Trajectory Format](https://ykoh42.github.io/async-hermes-agent/developer-guide/trajectory-format): JSONL records produced by individual agent turns and the async batch runner - [Upstream Differences](https://ykoh42.github.io/async-hermes-agent/developer-guide/upstream-differences): The deliberate differences between Hermes Agent v2026.8.13 and Async Hermes Agent ## Reference - [Environment Variables](https://ykoh42.github.io/async-hermes-agent/reference/environment-variables): State location and credential environment variables used by the library - [FAQ & Troubleshooting](https://ykoh42.github.io/async-hermes-agent/reference/faq): Common integration, async lifecycle, provider, MCP, session, and trajectory questions - [MCP Configuration Reference](https://ykoh42.github.io/async-hermes-agent/reference/mcp-config-reference): Configure native-async MCP stdio, Streamable HTTP, and SSE clients - [Tools Reference](https://ykoh42.github.io/async-hermes-agent/reference/tools-reference): Retained built-in tools, required arguments, and availability behavior - [Toolsets Reference](https://ykoh42.github.io/async-hermes-agent/reference/toolsets-reference): Static tool groups and dynamically registered MCP/plugin toolsets