--- type: "firecrawl-provider" description: "Official Hermes Agent sources from hermes-agent.nousresearch.com (Nous Research): full-text docs search through the site's public Algolia DocSearch index, any docs page as Markdown with an outline and section reads (English and Simplified Chinese), the llms.txt page index, a landing-page overview (install commands, desktop packages, features), the Plugin Catalogue, the curated model catalog Hermes ships for Nous Portal and OpenRouter, and release notes. Docs, catalogs and README come from the MIT-licensed NousResearch/hermes-agent repository and the JSON it publishes; release notes from its GitHub releases feed. No login or key. Nous Portal and the nousresearch.com blog are not covered: their terms restrict automated access and redistribution." use_when: "Official Hermes Agent sources from hermes-agent.nousresearch.com (Nous Research): full-text docs search through the site's public Algolia DocSearch index, any docs page as Markdown with an outline and section reads (English and Simplified Chinese), the llms.txt page index, a landing-page overview (install commands, desktop packages, features), the Plugin Catalogue, the curated model catalog Hermes ships for Nous Portal and OpenRouter, and release notes. Docs, catalogs and README come from the MIT-licensed NousResearch/hermes-agent repository and the JSON it publishes; release notes from its GitHub releases feed. No login or key. Nous Portal and the nousresearch.com blog are not covered: their terms restrict automated access and redistribution." categories: "Developer" capabilities: 7 credits_per_call: 5 --- # Hermes Agent Docs (Nous Research) on Firecrawl Alexandria Official Hermes Agent sources from hermes-agent.nousresearch.com (Nous Research): full-text docs search through the site's public Algolia DocSearch index, any docs page as Markdown with an outline and section reads (English and Simplified Chinese), the llms.txt page index, a landing-page overview (install commands, desktop packages, features), the Plugin Catalogue, the curated model catalog Hermes ships for Nous Portal and OpenRouter, and release notes. Docs, catalogs and README come from the MIT-licensed NousResearch/hermes-agent repository and the JSON it publishes; release notes from its GitHub releases feed. No login or key. Nous Portal and the nousresearch.com blog are not covered: their terms restrict automated access and redistribution. - Categories: Developer - Category index: [Developer category](https://firecrawl.dev/alexandria/agents/categories/developer) - Provider key: `nousresearch-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/nousresearch-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/openapi.json) ## Capabilities - [Changelog](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/changelog): Hermes Agent release notes, newest first, from the GitHub releases Atom feed of NousResearch/hermes-agent (the docs site has no changelog page; `/docs/changelog` is 404 there). The feed holds the 10 latest releases including canaries; canaries are skipped unless `include_canary`. `version` selects one tag (a tag not in the feed is `not_found`; older history is in the github-com program). `q` matches note text. - [Get page](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/get_page): One Hermes Agent docs page as Markdown, read from the page's source in the NousResearch/hermes-agent repository (`website/docs`, the tree the site is built from) because the site publishes no per-page Markdown. Returns title, front matter description, an outline of headings with the site's anchors, and the content. `section` (heading text or anchor, case-insensitive) returns only that heading and its subsections. Accepts a page path or a docs URL; an anchor in the URL selects that section. `zh-Hans` reads the translation and falls back to English like the site. Unknown pages and sections are `not_found`. - [List pages](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/list_pages): Every page in the Hermes Agent docs index (GET /docs/llms.txt, published for agents) with title, path, URL, one-line description and navigation group. `q` filters title, path and description; `group` filters the navigation group (e.g. `Messaging Platforms`). Accepts the pasted URL of llms.txt or llms-full.txt (both index the same pages; read full text per page with get_page). Paginated with `limit`/`offset`. - [Model catalog](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/model_catalog): The curated model catalog Hermes Agent ships (GET /docs/api/model-catalog.json, generated from the hermes-agent repository): per provider (`nous` for Nous Portal, `openrouter`) the model ids Hermes offers in its picker, the default model and picker notes. It is Hermes' own list, not Nous Portal's live catalog or prices. - [Overview](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/overview): What the hermes-agent.nousresearch.com landing pages (/ and /desktop) tell a visitor: title, one-paragraph summary, feature list, the official installer one-liners per platform, the desktop package notes and key links. Built from the MIT-licensed README and the docs installation page in NousResearch/hermes-agent rather than the marketing HTML, so the facts match the shipped project; `readme` carries the README Markdown (cut at `max_chars`). - [Plugins](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/plugins): The Hermes Agent Plugin Catalogue (hermes-agent.nousresearch.com/docs/plugins): every listed plugin with description, category, tier, maintainer, repository and pinned commit, install command, capabilities (tools, hooks, required env names), stars and dates. Read from `/docs/api/plugins.json`, the file the docs build generates from the repository's `plugin-catalog/*.yaml` and that installed Hermes clients fetch. Filters: exact `name`, text `q`, `category`, `tier`, `maintainer`; paginated. A pasted `/docs/plugins/{name}` or `/docs/plugins/by/{maintainer}` URL selects that plugin or maintainer. An unknown `name` is `not_found`. - [Search docs](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/search_docs): Search the Hermes Agent docs through the site's own Algolia DocSearch index (the search box on hermes-agent.nousresearch.com/docs, public search-only key). Returns ranked section and paragraph hits in the index's order with heading hierarchy, URL, page path, section anchor and the matching paragraph. Keyword search with typo tolerance; `language` selects English or Simplified Chinese pages. ## 1. Choose this provider when Official Hermes Agent sources from hermes-agent.nousresearch.com (Nous Research): full-text docs search through the site's public Algolia DocSearch index, any docs page as Markdown with an outline and section reads (English and Simplified Chinese), the llms.txt page index, a landing-page overview (install commands, desktop packages, features), the Plugin Catalogue, the curated model catalog Hermes ships for Nous Portal and OpenRouter, and release notes. Docs, catalogs and README come from the MIT-licensed NousResearch/hermes-agent repository and the JSON it publishes; release notes from its GitHub releases feed. No login or key. Nous Portal and the nousresearch.com blog are not covered: their terms restrict automated access and redistribution. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "nousresearch-com", "capability": "developer-documentation/changelog", "options": { "limit": 2 } } ``` ## 3. Add provider options Use only the options needed for the task: - `include_canary` (boolean): Include canary prereleases. Defaults to false. Example: `false` - `limit` (number): Releases to return, 1-10. Defaults to 5. Example: `10` - `q` (string): Text to match in release titles or notes. Example: `` - `url` (string): Optionally the pasted https://hermes-agent.nousresearch.com/docs/changelog URL; it selects nothing extra. Pattern: ^https?://. Example: `` - `version` (string): Release tag, e.g. `v0.22.4` (a leading `v` is optional). Example: `v0.22.4` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "nousresearch-com", capability: "developer-documentation/changelog", options: { limit: 2, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "nousresearch-com", "capability": "developer-documentation/changelog", "options": { "limit": 2 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "nousresearch-com", "capability": "developer-documentation/changelog", "options": { "limit": 2 } } }' ``` ### CLI ```sh firecrawl scrape 'nousresearch-com/developer-documentation/changelog' \ --options '{"limit":2}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "nousresearch-com", "capability": "developer-documentation/changelog", "options": { "limit": 2 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "nousresearch-com", "capability": "developer-documentation/changelog", "options": { "limit": 2 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "count": 2, "feed_count": 10, "observed_at_ms": 1792699200000, "query": { "include_canary": false, "limit": 2, "q": null, "version": null }, "releases": [ { "notes": "# Hermes Agent v0.22.4\n\n**Release Date:** October 21, 2026\n\nPatch release. Desktop stops showing suggestion pills above the composer, plus small plugin and dashboard fixes, for the CLI and installer, the Microsoft Store app, Docker and Hermes Cloud.\n\n## Fixes\n\n- **Desktop no longer shows suggestion pills above the composer.** The pills appeared for no clear reason, mostly nudging you to set up MCP servers. They and the helpers that only they used are gone. (#142559)\n\n- **Plugins that install nothing skip the dependency consent step.** A plugin that declares no dependencies, or whose `pyproject.toml` installs nothing, now enables without an empty consent prompt. (#142569)\n\n- **Dashboard: WhatsApp can be safely re-paired after logging out.** (#142439)\n\n- **Desktop plugin review:** the surface lint no longer flags prototype writes; reviewers check them by hand. (#142586)\n\n- **Desktop: the approval-mode chip follows the active profile's mode.** (#142565)\n\n- **Release builds:** the desktop bundle's pre-build check gets enough time to verify archived build inputs when storage is slow. (#142623)\n\nAlso new in the plugin catalog: bubblewrap (bwrap terminal backend on Linux), Singularity/Apptainer, mcp-serve (Hermes as an MCP server), agent-importers (`hermes import-agent`, now with Cursor), inbox and workflow-record from Hermes Labs. Telegram Business moves to the Hermes Labs community tier.\n\n## About this release\n\nMeasured at commit `4d04303818b`, the window since v0.22.3 contains **14 non-merge commits** across **82 changed files** (+1,475 / −3,022) and **13 merged PRs**.\n\n## Updating\n\n- Microsoft Store app: updates through the Store.\n\n- Desktop app installed from the installer (.exe / .dmg): no change in this release; it updates with the next bundled release.\n\n- CLI: `hermes update`, or re-run the installer one-liner.\n\n- Docker / Hermes Cloud: `nousresearch/hermes-agent:stable` (or `:latest`).\n\n**Full Changelog**: v0.22.3...v0.22.4", "prerelease": false, "published_at": "2026-10-21T18:49:24Z", "title": "Hermes Agent v0.22.4", "url": "https://github.com/NousResearch/hermes-agent/releases/tag/v0.22.4", "version": "v0.22.4" }, { "notes": "# Hermes Agent v0.22.3\n\n**Release Date:** October 21, 2026\n\nPatch release. This tag rolls up the ~620 PRs merged since v0.22.2 into a stable release for the CLI and installer, the Microsoft Store app, Docker and Hermes Cloud. Full curated notes for this window ship with v0.23.0.\n\n## About this release\n\nMeasured at commit `5b147ab036d`, the window since v0.22.2 contains **2,911 non-merge commits** across **4,206 changed files** (+360,278 / −64,308), about **620 merged PRs** and **326 closed issues**.\n\nAlso in the window, undocumented here on purpose: MCP progress notifications streamed as live tool progress, a refreshed classic CLI layout (glyph transcript, status line under the composer, two-line header), OAuth clients that plugins declare and Hermes signs in and refreshes, `hermes plugins update` offering every available plugin update plus an Update button for git-installed plugins in Desktop, steering and editing a queued prompt from Desktop, a guided subagent model and provider picker in Desktop, a live `/loop` countdown row in the CLI and TUI, opt-in Telegram DM topic transfer, a `post_compaction` plugin hook, a capabilities catalog, the Microsoft Store build going live automatically when a release publishes, session auto-prune back to opt-in with a one-time prompt when disk runs low, Nemotron 3.5 Bolt and one-slot DFlash drafts in the local runtime, and dozens of new plugin catalog entries.\n\n**Full curated release notes for this window ship with v0.23.0**, which will document everything from v0.22.0 onward — highlights, feature areas, and complete contributor credits. Nothing in this window is skipped.\n\n## Updating\n\n- Microsoft Store app: updates through the Store.\n\n- Desktop app installed from the installer (.exe / .dmg): no change in this release; it updates with the next bundled release.\n\n- CLI: `hermes update`, or re-run the installer one-liner.\n\n- Docker / Hermes Cloud: `nousresearch/hermes-agent:stable` (or `:latest`).\n\n**Full Changelog**: v0.22.2...v0.22.3", "prerelease": false, "published_at": "2026-10-21T12:21:11Z", "title": "Hermes Agent v0.22.3", "url": "https://github.com/NousResearch/hermes-agent/releases/tag/v0.22.3", "version": "v0.22.3" } ], "releases_url": "https://github.com/NousResearch/hermes-agent/releases", "source_url": "https://github.com/NousResearch/hermes-agent/releases.atom" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Changelog - Capability: `developer-documentation/changelog` - Description: Hermes Agent release notes, newest first, from the GitHub releases Atom feed of NousResearch/hermes-agent (the docs site has no changelog page; `/docs/changelog` is 404 there). The feed holds the 10 latest releases including canaries; canaries are skipped unless `include_canary`. `version` selects one tag (a tag not in the feed is `not_found`; older history is in the github-com program). `q` matches note text. - Instructions: To see what changed in the latest Hermes Agent releases or read the notes of a recent version. - Cost: 5 credits per call - Capability file: [Changelog](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/changelog) Accepted options: - `include_canary` (boolean): Include canary prereleases. Defaults to false. Example: `false` - `limit` (number): Releases to return, 1-10. Defaults to 5. Example: `10` - `q` (string): Text to match in release titles or notes. Example: `` - `url` (string): Optionally the pasted https://hermes-agent.nousresearch.com/docs/changelog URL; it selects nothing extra. Pattern: ^https?://. Example: `` - `version` (string): Release tag, e.g. `v0.22.4` (a leading `v` is optional). Example: `v0.22.4` Response schema example: ```json { "count": 2, "feed_count": 10, "observed_at_ms": 1792699200000, "query": { "include_canary": false, "limit": 2, "q": null, "version": null }, "releases": [ { "notes": "# Hermes Agent v0.22.4\n\n**Release Date:** October 21, 2026\n\nPatch release. Desktop stops showing suggestion pills above the composer, plus small plugin and dashboard fixes, for the CLI and installer, the Microsoft Store app, Docker and Hermes Cloud.\n\n## Fixes\n\n- **Desktop no longer shows suggestion pills above the composer.** The pills appeared for no clear reason, mostly nudging you to set up MCP servers. They and the helpers that only they used are gone. (#142559)\n\n- **Plugins that install nothing skip the dependency consent step.** A plugin that declares no dependencies, or whose `pyproject.toml` installs nothing, now enables without an empty consent prompt. (#142569)\n\n- **Dashboard: WhatsApp can be safely re-paired after logging out.** (#142439)\n\n- **Desktop plugin review:** the surface lint no longer flags prototype writes; reviewers check them by hand. (#142586)\n\n- **Desktop: the approval-mode chip follows the active profile's mode.** (#142565)\n\n- **Release builds:** the desktop bundle's pre-build check gets enough time to verify archived build inputs when storage is slow. (#142623)\n\nAlso new in the plugin catalog: bubblewrap (bwrap terminal backend on Linux), Singularity/Apptainer, mcp-serve (Hermes as an MCP server), agent-importers (`hermes import-agent`, now with Cursor), inbox and workflow-record from Hermes Labs. Telegram Business moves to the Hermes Labs community tier.\n\n## About this release\n\nMeasured at commit `4d04303818b`, the window since v0.22.3 contains **14 non-merge commits** across **82 changed files** (+1,475 / −3,022) and **13 merged PRs**.\n\n## Updating\n\n- Microsoft Store app: updates through the Store.\n\n- Desktop app installed from the installer (.exe / .dmg): no change in this release; it updates with the next bundled release.\n\n- CLI: `hermes update`, or re-run the installer one-liner.\n\n- Docker / Hermes Cloud: `nousresearch/hermes-agent:stable` (or `:latest`).\n\n**Full Changelog**: v0.22.3...v0.22.4", "prerelease": false, "published_at": "2026-10-21T18:49:24Z", "title": "Hermes Agent v0.22.4", "url": "https://github.com/NousResearch/hermes-agent/releases/tag/v0.22.4", "version": "v0.22.4" }, { "notes": "# Hermes Agent v0.22.3\n\n**Release Date:** October 21, 2026\n\nPatch release. This tag rolls up the ~620 PRs merged since v0.22.2 into a stable release for the CLI and installer, the Microsoft Store app, Docker and Hermes Cloud. Full curated notes for this window ship with v0.23.0.\n\n## About this release\n\nMeasured at commit `5b147ab036d`, the window since v0.22.2 contains **2,911 non-merge commits** across **4,206 changed files** (+360,278 / −64,308), about **620 merged PRs** and **326 closed issues**.\n\nAlso in the window, undocumented here on purpose: MCP progress notifications streamed as live tool progress, a refreshed classic CLI layout (glyph transcript, status line under the composer, two-line header), OAuth clients that plugins declare and Hermes signs in and refreshes, `hermes plugins update` offering every available plugin update plus an Update button for git-installed plugins in Desktop, steering and editing a queued prompt from Desktop, a guided subagent model and provider picker in Desktop, a live `/loop` countdown row in the CLI and TUI, opt-in Telegram DM topic transfer, a `post_compaction` plugin hook, a capabilities catalog, the Microsoft Store build going live automatically when a release publishes, session auto-prune back to opt-in with a one-time prompt when disk runs low, Nemotron 3.5 Bolt and one-slot DFlash drafts in the local runtime, and dozens of new plugin catalog entries.\n\n**Full curated release notes for this window ship with v0.23.0**, which will document everything from v0.22.0 onward — highlights, feature areas, and complete contributor credits. Nothing in this window is skipped.\n\n## Updating\n\n- Microsoft Store app: updates through the Store.\n\n- Desktop app installed from the installer (.exe / .dmg): no change in this release; it updates with the next bundled release.\n\n- CLI: `hermes update`, or re-run the installer one-liner.\n\n- Docker / Hermes Cloud: `nousresearch/hermes-agent:stable` (or `:latest`).\n\n**Full Changelog**: v0.22.2...v0.22.3", "prerelease": false, "published_at": "2026-10-21T12:21:11Z", "title": "Hermes Agent v0.22.3", "url": "https://github.com/NousResearch/hermes-agent/releases/tag/v0.22.3", "version": "v0.22.3" } ], "releases_url": "https://github.com/NousResearch/hermes-agent/releases", "source_url": "https://github.com/NousResearch/hermes-agent/releases.atom" } ``` ### Get page - Capability: `developer-documentation/get_page` - Description: One Hermes Agent docs page as Markdown, read from the page's source in the NousResearch/hermes-agent repository (`website/docs`, the tree the site is built from) because the site publishes no per-page Markdown. Returns title, front matter description, an outline of headings with the site's anchors, and the content. `section` (heading text or anchor, case-insensitive) returns only that heading and its subsections. Accepts a page path or a docs URL; an anchor in the URL selects that section. `zh-Hans` reads the translation and falls back to English like the site. Unknown pages and sections are `not_found`. - Instructions: To read primary Hermes Agent documentation: install and update, CLI and TUI, config.yaml, model providers, memory, skills, cron, the messaging gateway, security, plugins and the developer guide. Call without `section` (with a small `max_chars`) to see the outline, then fetch the section you need. - Cost: 5 credits per call - Capability file: [Get page](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/get_page) Accepted options: - `language` (string): Docs language. Defaults to `en`, or to the language named in the path or URL. Example: `en` - `max_chars` (number): Cut `content` to this many characters. The whole page or section is returned when omitted. Example: `200` - `path` (string): Page path such as `user-guide/features/memory`, `zh-Hans/getting-started/quickstart` or `integrations/nous-portal#profile-setup`. A leading `docs/` and a `.md` suffix are accepted; `index` is the docs home. Example: `user-guide/features/memory` - `section` (string): Heading text or anchor of the section to return, e.g. `How It Works` or `how-it-works`. Example: `How It Works` - `url` (string): Alternatively a page URL, e.g. https://hermes-agent.nousresearch.com/docs/user-guide/features/memory#how-it-works. Pattern: ^https?://. Example: `` Response schema example: ```json { "chars": 1609, "content": "## How It Works\n\nTwo files make up the agent's memory:\n\n| File | Purpose | Char Limit |\n|------|---------|------------|\n| **MEMORY.md** | Agent's personal notes — environment facts, conventions, things learned | 2,200 chars (~800 tokens) |\n| **USER.md** | User profile — your preferences, communication style, expectations | 1,375 chars (~500 tokens) |\n\nBoth are stored in `~/.hermes/memories/` and are injected into the system prompt as a frozen snapshot at session start. The agent manages its own memory via the `memory` tool — it can add, patch, or remove entries.\n\n:::caution One agent per Hermes home\nDon't point two agent processes at the same Hermes home directory. Memory writes are automatic and load back into the system prompt at session start, so two writers sharing one home will compound each other's entries into state neither of them (nor you) authored. Memory is scoped per [profile](../profiles.md) by design — give a second agent its own profile, and if they need shared memory, use an [external memory provider](./memory-providers.md) instead.\n:::\n\n:::info\nCharacter limits keep memory focused. Memory does **not** auto-compact: when a\nwrite would exceed the limit, the `memory` tool returns an error instead of\nsilently dropping entries. The agent then makes room itself — consolidating or\nremoving entries in the same turn before retrying (see [What Happens When Memory\nis Full](#what-happens-when-memory-is-full)). Note that `patch` is also bound\nby the limit: a patch that lengthens an entry can still overflow, so the new\ntext must be shortened (or another entry removed) to fit.\n:::", "description": "How Hermes Agent remembers across sessions — MEMORY.md, USER.md, and session search", "language": "en", "observed_at_ms": 1792693763873, "outline": [ { "anchor": "how-it-works", "level": 2, "text": "How It Works" } ], "path": "user-guide/features/memory", "section": { "anchor": "how-it-works", "level": 2, "text": "How It Works", "url": "https://hermes-agent.nousresearch.com/docs/user-guide/features/memory#how-it-works" }, "source_language": "en", "source_url": "https://raw.githubusercontent.com/NousResearch/hermes-agent/main/website/docs/user-guide/features/memory.md", "title": "Persistent Memory", "truncated": false, "url": "https://hermes-agent.nousresearch.com/docs/user-guide/features/memory" } ``` ### List pages - Capability: `developer-documentation/list_pages` - Description: Every page in the Hermes Agent docs index (GET /docs/llms.txt, published for agents) with title, path, URL, one-line description and navigation group. `q` filters title, path and description; `group` filters the navigation group (e.g. `Messaging Platforms`). Accepts the pasted URL of llms.txt or llms-full.txt (both index the same pages; read full text per page with get_page). Paginated with `limit`/`offset`. - Instructions: To browse what the Hermes Agent docs cover, or to find a page path for get_page when you know roughly what it is called. - Cost: 5 credits per call - Capability file: [List pages](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/list_pages) Accepted options: - `group` (string): Case-insensitive part of a navigation group name, e.g. `Core Features` or `Reference`. Example: `Core Features` - `limit` (number): Pages per call, 1-500. Defaults to 100. Example: `10` - `offset` (number): Skip this many matching pages (use `next_offset`). Example: `10` - `q` (string): Case-insensitive text to match in title, path or description. Example: `` - `url` (string): Optionally https://hermes-agent.nousresearch.com/docs/llms.txt or /docs/llms-full.txt as pasted; it selects nothing extra. Pattern: ^https?://. Example: `` Response schema example: ```json { "count": 7, "next_offset": null, "observed_at_ms": 1792693763876, "pages": [ { "description": "Install Hermes Agent with desktop bundles, source installers, Docker, Nix, or the Termux APT package", "group": "Getting Started", "path": "getting-started/installation", "title": "Installation", "url": "https://hermes-agent.nousresearch.com/docs/getting-started/installation" }, { "description": "Your first conversation with Hermes Agent — from install to chatting in under 5 minutes", "group": "Getting Started", "path": "getting-started/quickstart", "title": "Quickstart", "url": "https://hermes-agent.nousresearch.com/docs/getting-started/quickstart" }, { "description": "Choose your learning path through the Hermes Agent documentation based on your experience level and goals.", "group": "Getting Started", "path": "getting-started/learning-path", "title": "Learning Path", "url": "https://hermes-agent.nousresearch.com/docs/getting-started/learning-path" }, { "description": "How to update Hermes Agent to the latest version or uninstall it", "group": "Getting Started", "path": "getting-started/updating", "title": "Updating", "url": "https://hermes-agent.nousresearch.com/docs/getting-started/updating" }, { "description": "Install and deploy Hermes Agent with Nix — from quick `nix run` to fully declarative NixOS module with container mode", "group": "Getting Started", "path": "getting-started/nix-setup", "title": "Nix Setup", "url": "https://hermes-agent.nousresearch.com/docs/getting-started/nix-setup" }, { "description": "Which operating systems, distribution methods, and features Hermes Agent supports.", "group": "Getting Started", "path": "getting-started/platform-support", "title": "Platform Support", "url": "https://hermes-agent.nousresearch.com/docs/getting-started/platform-support" }, { "description": "Install Hermes Agent on Android from its signed Termux APT repository", "group": "Getting Started", "path": "getting-started/termux", "title": "Android / Termux", "url": "https://hermes-agent.nousresearch.com/docs/getting-started/termux" } ], "query": { "group": "Getting Started", "limit": 100, "offset": 0, "q": null }, "source_url": "https://hermes-agent.nousresearch.com/docs/llms.txt", "total_count": 7 } ``` ### Model catalog - Capability: `developer-documentation/model_catalog` - Description: The curated model catalog Hermes Agent ships (GET /docs/api/model-catalog.json, generated from the hermes-agent repository): per provider (`nous` for Nous Portal, `openrouter`) the model ids Hermes offers in its picker, the default model and picker notes. It is Hermes' own list, not Nous Portal's live catalog or prices. - Instructions: To see which models Hermes Agent offers through Nous Portal or OpenRouter, or which model it defaults to. - Cost: 5 credits per call - Capability file: [Model catalog](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/model_catalog) Accepted options: - `provider` (string): Provider key, e.g. `nous` or `openrouter`. All providers when omitted; an unknown key is `not_found`. Example: `` - `q` (string): Text to match in model ids, e.g. `claude`. Example: `` Response schema example: ```json { "observed_at_ms": 1792699200000, "providers": [ { "count": 57, "display_name": "Nous Portal", "models": [ { "default": false, "description": null, "id": "anthropic/claude-fable-5.1" }, { "default": false, "description": null, "id": "anthropic/claude-fable-5" }, { "default": false, "description": null, "id": "anthropic/claude-opus-5.5" }, { "default": false, "description": null, "id": "anthropic/claude-opus-5" }, { "default": false, "description": null, "id": "anthropic/claude-opus-4.8" }, { "default": false, "description": null, "id": "anthropic/claude-sonnet-5.5" }, { "default": false, "description": null, "id": "anthropic/claude-sonnet-5" }, { "default": false, "description": null, "id": "anthropic/claude-haiku-5.5" }, { "default": false, "description": null, "id": "anthropic/claude-haiku-4.5" }, { "default": false, "description": null, "id": "openai/gpt-6-astra" }, { "default": false, "description": null, "id": "openai/gpt-6-astra-fast" }, { "default": false, "description": null, "id": "openai/gpt-6-astra-flex" }, { "default": false, "description": null, "id": "openai/gpt-6-astra-pro" }, { "default": false, "description": null, "id": "openai/gpt-6-astra-pro-fast" }, { "default": false, "description": null, "id": "openai/gpt-6-astra-pro-flex" }, { "default": false, "description": null, "id": "openai/gpt-6.1-sol" }, { "default": false, "description": null, "id": "openai/gpt-6.1-sol-pro" }, { "default": false, "description": null, "id": "openai/gpt-6-sol" }, { "default": false, "description": null, "id": "openai/gpt-6-sol-pro" }, { "default": false, "description": null, "id": "openai/gpt-6-luna" }, { "default": false, "description": null, "id": "openai/gpt-6-luna-pro" }, { "default": false, "description": null, "id": "openai/gpt-5.5" }, { "default": false, "description": null, "id": "openai/gpt-5.5-pro" }, { "default": false, "description": null, "id": "openai/gpt-5.4-mini" }, { "default": false, "description": null, "id": "google/gemini-4-argon" }, { "default": false, "description": null, "id": "google/gemini-3.1-pro-preview" }, { "default": false, "description": null, "id": "google/gemini-3.8-flash" }, { "default": false, "description": null, "id": "google/gemini-3.7-flash" }, { "default": false, "description": null, "id": "x-ai/grok-4.7" }, { "default": false, "description": null, "id": "x-ai/grok-4.6" }, { "default": false, "description": null, "id": "deepseek/deepseek-v4-pro" }, { "default": false, "description": null, "id": "deepseek/deepseek-v4-pro-0813" }, { "default": false, "description": null, "id": "deepseek/deepseek-v4.1-flash" }, { "default": false, "description": null, "id": "deepseek/deepseek-v4.1-flash-1017" }, { "default": false, "description": null, "id": "deepseek/deepseek-v4-flash-0731" }, { "default": false, "description": null, "id": "qwen/qwen3.8-max-0902" }, { "default": false, "description": null, "id": "qwen/qwen3.8-flash" }, { "default": false, "description": null, "id": "moonshotai/kimi-k3" }, { "default": false, "description": null, "id": "minimax/minimax-m3" }, { "default": false, "description": null, "id": "z-ai/glm-5.3" }, { "default": false, "description": null, "id": "z-ai/glm-5.3-flash" }, { "default": false, "description": null, "id": "z-ai/glm-5.3-flashx" }, { "default": true, "description": null, "id": "z-ai/glm-5.2" }, { "default": false, "description": null, "id": "xiaomi/mimo-v2.6-pro" }, { "default": false, "description": null, "id": "xiaomi/mimo-v2.6-flash" }, { "default": false, "description": null, "id": "xiaomi/mimo-v2.6-pro-ultraspeed" }, { "default": false, "description": null, "id": "xiaomi/mimo-v2.5-pro" }, { "default": false, "description": null, "id": "tencent/hy4-preview" }, { "default": false, "description": null, "id": "tencent/hy3" }, { "default": false, "description": null, "id": "stepfun/step-3.7-flash" }, { "default": false, "description": null, "id": "nvidia/nemotron-3-super-120b-a12b" }, { "default": false, "description": null, "id": "meta/muse-spark-1.2" }, { "default": false, "description": null, "id": "meta/muse-spark-1.3" }, { "default": false, "description": null, "id": "sakana/fugu-ultra" }, { "default": false, "description": null, "id": "upstage/solar-pro4" }, { "default": false, "description": null, "id": "upstage/solar-mini4" }, { "default": false, "description": null, "id": "stealth/space-bunny-alpha" } ], "note": "The entry labeled \"default\": true is the model Hermes silently lands on when the user never picked one.", "provider": "nous" } ], "query": { "provider": "nous", "q": null }, "source_url": "https://hermes-agent.nousresearch.com/docs/api/model-catalog.json", "total_count": 57, "updated_at": "2026-10-17T11:22:42Z" } ``` ### Overview - Capability: `developer-documentation/overview` - Description: What the hermes-agent.nousresearch.com landing pages (/ and /desktop) tell a visitor: title, one-paragraph summary, feature list, the official installer one-liners per platform, the desktop package notes and key links. Built from the MIT-licensed README and the docs installation page in NousResearch/hermes-agent rather than the marketing HTML, so the facts match the shipped project; `readme` carries the README Markdown (cut at `max_chars`). - Instructions: When an agent has the Hermes Agent homepage or the Hermes Desktop page and needs what Hermes Agent is, how to install it (curl or PowerShell one-liner), or where the desktop app comes from. Use get_page for the full installation or desktop guide. - Cost: 5 credits per call - Capability file: [Overview](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/overview) Accepted options: - `max_chars` (number): Cut `readme` to this many characters. The whole README is returned when omitted. Example: `100` - `url` (string): The landing page URL, https://hermes-agent.nousresearch.com/ or /desktop. Defaults to the homepage. Pattern: ^https?://. Example: `` Response schema example: ```json { "desktop_packages": "Download the package for your platform from the\n[Hermes website](https://hermes-agent.nousresearch.com/).\n\n- **Windows:** open the `.appinstaller` download with Windows App Installer.\n It installs the signed MSIX bundle and records its update source.\n Microsoft Store packages have separate Store ownership.\n- **macOS:** open the DMG, then copy `Hermes.app` to Applications. The ZIP\n artifact carries the signed app used by the automatic updater.\n\nBundled packages contain the agent, Python, supported dependencies, and prebuilt\ninterfaces. First launch does not build that base runtime. Provider access and\noptional integrations can still require network access.\n\nA `Hermes-Setup` bootstrap installer is different: it downloads a source\ninstallation and builds the desktop app. See [Hermes Desktop](../user-guide/desktop.md).\n\nThere is no separate remote-only Desktop download. To use Desktop with a Hermes\nbackend on another machine, install one of the packages above and connect it\nfrom **Settings → Gateways**; see\n[Connecting to a remote backend](../user-guide/desktop.md#connecting-to-a-remote-backend).\n\n:::note\nThe macOS installer is **Apple Silicon only**. macOS on x86 (Intel) processors is [not a supported platform](./platform-support.md#unsupported).\n:::", "features": [ { "description": "Full TUI with multiline editing, slash-command autocomplete, conversation history, interrupt-and-redirect, and streaming tool output.", "title": "A real terminal interface" }, { "description": "Telegram, Discord, Slack, WhatsApp, Signal, and CLI — all from a single gateway process. Voice memo transcription, cross-platform conversation continuity.", "title": "Lives where you do" }, { "description": "Agent-curated memory with periodic nudges. Autonomous skill creation after complex tasks. Skills self-improve during use. FTS5 session search with LLM summarization for cross-session recall. Honcho dialectic user modeling. Compatible with the agentskills.io open standard.", "title": "A closed learning loop" }, { "description": "Built-in cron scheduler with delivery to any platform. Daily reports, nightly backups, weekly audits — all in natural language, running unattended.", "title": "Scheduled automations" }, { "description": "Spawn isolated subagents for parallel workstreams. In Desktop, choose their provider, model, and limits under Settings → Model → Subagents, then Apply the complete route. Write Python scripts that call tools via RPC, collapsing multi-step pipelines into zero-context-cost turns.", "title": "Delegates and parallelizes" }, { "description": "Six built-in terminal backends — local, Docker, SSH, Modal, Daytona, and Vercel Sandbox — plus plugin backends such as Singularity/Apptainer. Daytona and Modal offer serverless persistence — your agent's environment hibernates when idle and wakes on demand, costing nearly nothing between sessions. Run it on a $5 VPS or a GPU cluster.", "title": "Runs anywhere, not just your laptop" }, { "description": "Batch trajectory generation, trajectory compression for training the next generation of tool-calling models.", "title": "Research-ready" } ], "install_commands": [ { "command": "curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash", "platform": "Linux / macOS / WSL2", "shell": "bash" }, { "command": "iex (irm https://hermes-agent.nousresearch.com/install.ps1)", "platform": "Windows (native)", "shell": "powershell" } ], "license": "MIT", "links": { "desktop_guide": "https://hermes-agent.nousresearch.com/docs/user-guide/desktop", "desktop_page": "https://hermes-agent.nousresearch.com/desktop", "docs": "https://hermes-agent.nousresearch.com/docs/", "installation": "https://hermes-agent.nousresearch.com/docs/getting-started/installation", "repository": "https://github.com/NousResearch/hermes-agent" }, "observed_at_ms": 1792699200000, "page": "home", "readme": "# Hermes Agent ☤\n

\n Hermes Agent | Hermes Desktop\n

\n

\n \"Documentation\"\n ` - `name` (string): Exact plugin name (case-insensitive), e.g. `brave-search`. Example: `brave-search` - `offset` (number): Skip this many matching plugins (use `next_offset`). Example: `10` - `q` (string): Text to match in name, description or provided tool names. Example: `` - `tier` (string): tier Example: `official` - `url` (string): A Plugin Catalogue URL: /docs/plugins, /docs/plugins/{name} or /docs/plugins/by/{maintainer}. Pattern: ^https?://. Example: `` Response schema example: ```json { "catalog_total": 8, "count": 1, "next_offset": null, "observed_at_ms": 1792699200000, "plugins": [ { "added_at": "2026-09-15T12:55:47-07:00", "category": "web", "description": "Brave Search API tools for live web search inside Hermes", "docs_url": "https://github.com/rabilrbl/hermes-brave-search-plugin#readme", "featured_rank": null, "install_command": "hermes plugins install brave-search", "maintainer": "rabilrbl", "maintainer_slug": "rabilrbl", "name": "brave-search", "page_url": "https://hermes-agent.nousresearch.com/docs/plugins/brave-search", "platforms": [], "provides_hooks": [], "provides_tools": [ "brave_web_search" ], "readme_url": "https://raw.githubusercontent.com/rabilrbl/hermes-brave-search-plugin/4134cbef910c14c63e6b284b0820b30f3811ab47/README.md", "repo": "https://github.com/rabilrbl/hermes-brave-search-plugin", "requires_env": [ "name" ], "requires_hermes": null, "sha": "4134cbef910c14c63e6b284b0820b30f3811ab47", "stars": 3, "subdir": null, "tier": "community", "updated_at": "2026-09-15T12:55:47-07:00", "version": null } ], "query": { "category": null, "limit": 25, "maintainer": null, "name": "brave-search", "offset": 0, "q": null, "tier": null }, "source_url": "https://hermes-agent.nousresearch.com/docs/api/plugins.json", "total_count": 1 } ``` ### Search docs - Capability: `developer-documentation/search_docs` - Description: Search the Hermes Agent docs through the site's own Algolia DocSearch index (the search box on hermes-agent.nousresearch.com/docs, public search-only key). Returns ranked section and paragraph hits in the index's order with heading hierarchy, URL, page path, section anchor and the matching paragraph. Keyword search with typo tolerance; `language` selects English or Simplified Chinese pages. - Instructions: To find which Hermes Agent docs page and section covers a topic (installation, configuration, providers, memory, skills, cron, messaging gateway, plugins, Nous Portal setup). Pass a hit's `path` and `anchor` to get_page as `path` and `section` for the full text. - Cost: 5 credits per call - Capability file: [Search docs](https://firecrawl.dev/alexandria/agents/providers/nousresearch-com/developer-documentation/search_docs) Accepted options: - `language` (string): Docs language. Defaults to `en`. Example: `en` - `limit` (number): Maximum hits, 1-20. Defaults to 10. Example: `10` - `query` (string, required): Search text, e.g. `memory providers honcho`. Example: `memory providers honcho` Response schema example: ```json { "count": 3, "language": "en", "observed_at_ms": 1792693763871, "query": "memory providers honcho", "results": [ { "anchor": "honcho", "content": null, "hierarchy": [ "Memory Providers", "Available Providers", "Honcho" ], "language": "en", "path": "user-guide/features/memory-providers", "rank": 1, "title": "Honcho", "type": "lvl3", "url": "https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers#honcho" }, { "anchor": "new-profile-fresh-honcho-peer", "content": null, "hierarchy": [ "Memory Providers", "Available Providers", "New profile, fresh Honcho peer" ], "language": "en", "path": "user-guide/features/memory-providers", "rank": 2, "title": "New profile, fresh Honcho peer", "type": "lvl3", "url": "https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers#new-profile-fresh-honcho-peer" }, { "anchor": "existing-profiles-backfill-honcho-peers", "content": null, "hierarchy": [ "Memory Providers", "Available Providers", "Existing profiles, backfill Honcho peers" ], "language": "en", "path": "user-guide/features/memory-providers", "rank": 3, "title": "Existing profiles, backfill Honcho peers", "type": "lvl3", "url": "https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers#existing-profiles-backfill-honcho-peers" } ], "source_url": "https://2jlbveyzn5-dsn.algolia.net/1/indexes/hermes%20docs/query", "total_hits": 50 } ```