v0.20.1.2

Fork-only revision 2: this release tracks Hermes Agent v2026.8.13 (Python 0.20.1). Reinstall explicitly when moving from the legacy v0.20.4 fork release; future fork-only releases increment the fourth numeric segment.

What's Changed

• Bound workload identity credentials and cover EKS IRSA by @ykoh42 in #23

Full Changelog: v0.20.1.1...v0.20.1.2

v0.20.1.1

Upstream migration: this release tracks Hermes Agent v2026.8.13 (Python 0.20.1) with async revision 1. Reinstall explicitly when moving from the legacy v0.20.4 fork release; future fork-only releases increment the fourth numeric segment.

What's Changed

• [codex] modernize Python 3.11 runtime and harden async lifecycle by @ykoh42 in #16

Full Changelog: v0.20.0.5...v0.20.1.1

v0.20.0.5

Versioning migration: releases through v0.20.4 used the legacy fork-only sequence. Python version ordering will not select 0.20.0.5 as an upgrade from 0.20.4, so replace old pins and run uv pip install --reinstall "async-hermes-agent==0.20.0.5" once. Future versions use upstream X.Y.Z plus a fourth async revision.

Full Changelog: v0.20.4...v0.20.0.5

Async Hermes Agent v0.20.4

What's Changed

• Prepare reliable PyPI release v0.20.4 by @ykoh42 in #14

Full Changelog: v0.20.3...v0.20.4

Async Hermes Agent v0.20.3

What's Changed

• Publish native async documentation on GitHub Pages by @ykoh42 in #9
• test: isolate async SQLite startup from dual detectors by @ykoh42 in #10
• fix: preload core turn dependencies by @ykoh42 in #11
• Release v0.20.3 hotfix by @ykoh42 in #12
• Complete native async runtime boundaries by @ykoh42 in #13

Full Changelog: v0.20.2...v0.20.3

Async Hermes Agent v0.20.2

Native-async, library-focused distribution based on NousResearch Hermes Agent v2026.8.3 (v0.20.0). This release completes the retained runtime migration while preserving upstream core module paths and public names.

Highlights:

• Keeps AIAgent, run_conversation(), chat(), close(), SessionDB, runner, and batch-runner names in their existing locations; I/O-bearing calls are awaited.
• Runs the retained model, tool, MCP, skill, memory, session, trajectory, delegation, runner, and batch-runner paths with native asyncio.
• Preserves prompt-cache stability, role alternation, ordered tool observations, interleaved reasoning, trajectory shape, checkpoint/resume behavior, and session persistence.
• Uses lazy awaited provider, plugin, MCP, and database initialization while keeping AIAgent.__init__() state-only.
• Serializes concurrent turns on one agent instance and allows separate agents to run concurrently.
• Removes the product-only CLI/TUI, desktop/dashboard, messaging, cron, and bundled web-service surfaces from this library distribution.
• Provides no sync wrapper, asyncio.to_thread() fallback, run_until_complete(), or blocking .result() path in the retained runtime.

Compatibility note:

• This is an async-only distribution. Existing Hermes library integrations normally keep their imports and function names, then add await to I/O-bearing calls.
• It is intentionally a divergent library distribution, not a drop-in replacement for the full synchronous upstream product.

Verification:

• GitHub CI: 794 test files, 8,079 tests passed, 0 failed.
• Ruff and native-async static audits passed, including flake8-async checks for blocking calls and unawaited async APIs.
• Event-loop blocking, task-leak, cancellation, session, Skill, MCP, and ordered trajectory contracts passed.
• Wheel and sdist builds passed twine check.
• The wheel installed in an isolated Python 3.13 environment and exposed the expected coroutine API from site-packages.

Install:

uv pip install "git+https://github.com/ykoh42/async-hermes-agent.git@v0.20.2"

Artifacts:

• async_hermes_agent-0.20.2-py3-none-any.whl
• async_hermes_agent-0.20.2.tar.gz
• SHA256SUMS

Async Hermes Agent v0.20.1

Native-async distribution based on NousResearch Hermes Agent v2026.8.3 / v0.20.0. This patch release contains the async stabilization, training-trajectory, Skill/MCP integration, and library-workflow work completed after the initial migration release.

Highlights:

• Keeps upstream module paths, public function names, arguments, and return shapes; callers normally add await.
• Uses native async for the retained agent, provider, tool, MCP, session, trajectory, runner, and batch-runner paths.
• Retains skills, MCP, memory, session persistence, interleaved-reasoning trajectories, terminal/file tools, providers, delegation, and batch data generation.
• Has no sync compatibility wrapper or asyncio.to_thread fallback in the active runtime.
• Adds regression coverage for reasoning/tool/observation/final-answer trajectory ordering and an installed-package Skill + MCP trajectory path.
• Documents direct library usage for conversations, batching, Skill installation, MCP registration, memory, and trajectories.

Compatibility note:

• This is an async-only distribution. Existing Hermes library call sites keep the same imports and function names, but async operations must be awaited.

Verification:

• 6,823 tests passed across 702 isolated test files; 0 failed.
• Lockfile consistency, release metadata, wheel ZIP integrity, and clean Python 3.12 wheel installation passed.
• The installed wheel completed Skill discovery/view and MCP invocation while asyncio.to_thread was configured to fail.
• Session persistence produced two complete interleaved trajectories with no leaked MCP tasks.
• Live OpenRouter model/tool/observation/trajectory checks passed during release qualification.

Install:

uv pip install "git+https://github.com/ykoh42/async-hermes-agent.git@v0.20.1"

Artifacts:

• async_hermes_agent-0.20.1-py3-none-any.whl
• async_hermes_agent-0.20.1.tar.gz
• SHA256SUMS

See UPSTREAM_MIGRATION.md for the porting ledger and behavior-contract evidence.

Async Hermes Agent v0.20.0

Native-async distribution based on NousResearch Hermes Agent v2026.8.3 / v0.20.0. The repository and package name identify the async distribution, while the version stays aligned with the corresponding upstream feature release.

Highlights:

• Keeps upstream module paths, public function names, arguments, and return shapes; callers normally add await.
• Converts the active agent, provider, tool, MCP, session, trajectory, runner, and batch-runner paths to native async.
• Retains skills, MCP, memory, session persistence, interleaved reasoning trajectories, terminal/file tools, providers, delegation, and batch data generation.
• Excludes the classic CLI/TUI, desktop/dashboard, messaging gateway adapters, cron, ACP/A2A, bundled optional skill collections, and FastAPI application code.
• Uses aiosqlite and aiofiles for retained persistence; no asyncio.to_thread, executor, run_until_complete, or sync compatibility API in the active runtime.

Verification:

• 6,815 tests passed across 700 files.
• Full Ruff and async blocking-call lint passed.
• Lockfile, sdist/wheel build, clean-wheel import, and public coroutine contract checks passed.
• Live OpenRouter openai/gpt-oss-20b:free model → terminal tool → observation → reasoning → trajectory E2E passed.

Install:
uv pip install "git+https://github.com/ykoh42/async-hermes-agent.git@v0.20.0"

See UPSTREAM_MIGRATION.md for the porting ledger and behavior-contract evidence.