NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1784 most downloaded on PyPI
OpenHands Tools - Runtime tools for AI agents
Last release today
03 Oct 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 months old
101 releases · first in 2025
One column per month.
fix(settings): deprecate ACPAgentSettings.llm so ACP agents keep their metrics LLM by @simonrosenberg in #5434
Full Changelog: v1.50.1...v1.51.0
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
Full Changelog: v1.50.0...v1.50.1
fix(deps): bump anyio to 4.14.2 for CVE-2026-63374 by @neubig in #5361
Full Changelog: v1.49.6...v1.50.0
Add Pareto prompt meta-profile routing by @juanmichelini in #4287
Full Changelog: v1.49.5...v1.49.6
chore(tests): remove deprecated gpt-5.2-codex from tests by @juanmichelini in #5233
Full Changelog: v1.49.4...v1.49.5
fix(secret): resolve this server's own LookupSecret URLs in-process by @lkshrk in #5026
Full Changelog: v1.49.3...v1.49.4
feat: register deepseek-v4.1-flash as a verified model by @juanmichelini in #4940
Full Changelog: v1.49.2...v1.49.3
fix(agent-server): preserve legacy conversations in Docker catalogs by @neubig in #5128
Full Changelog: v1.49.1...v1.49.2
fix(agent-server): preserve Docker conversation metadata route by @neubig in #5112
Full Changelog: v1.49.0...v1.49.1
chore(agent-server): remove deprecated desktop URL endpoint past its 1.49.0 deadline by @enyst in #5105
Full Changelog: v1.48.0...v1.49.0
fix(ci): open PR for merged artifact cleanup by @enyst in #4933
Full Changelog: v1.47.0...v1.48.0
feat(agent-server): add OpenAI Responses gateway by @enyst in #4694
Full Changelog: v1.46.0...v1.47.0
fix(ci): centralize release publication dispatches by @neubig in #4886
Full Changelog: v1.45.0...v1.46.0
refactor(agent-server,ci): remove overdue org_config field and catch this class of gap in check_deprecations.py by @simonrosenberg in #4795
Full Changelog: v1.44.1...v1.45.0
feat(agent-server): add INSTALL_ACP_PROVIDERS build arg by @simonrosenberg in #4687
Full Changelog: v1.44.0...v1.44.1
fix(agent-server): keep crash recovery result on interrupted action branch by @neubig in #4488
Full Changelog: v1.43.1...v1.44.0
chore(deps): bump gitpython from 3.1.50 to 3.1.58 by @dependabot [bot] in #4545
Full Changelog: v1.43.0...v1.43.1
feat(plugin): add Agent Plugins manifest loader (root plugin.json, closed schema) by @VascoSch92 in #4474
Full Changelog: v1.42.1...v1.43.0
fix(goal): don't halt the goal loop on a STUCK run by @all-hands-bot in #4381
Full Changelog: v1.42.0...v1.42.1
chore(acp): bump pinned claude-agent-acp to 0.63.0, codex-acp to 1.1.7 by @simonrosenberg in #4391
Full Changelog: v1.41.0...v1.42.0
chore: remove deprecated features past their 1.41.0 removal deadline by @VascoSch92 in #4394
Full Changelog: v1.40.1...v1.41.0
chore(sdk): deprecate AgentBase.model_dump_succint by @AzeelSajjad in #4328
Full Changelog: v1.40.0...v1.40.1
Mark deprecated compatibility aliases by @neubig in #4004
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
Full Changelog: v1.39.1...v1.40.0
chore(release): remove OpenHands Index checklist item by @neubig in #4302
Full Changelog: v1.39.0...v1.39.1
ci: drop unmonitored nightly schedules from integration & examples workflows by @smolpaws in #4291
Full Changelog: v1.38.0...v1.39.0
docs(examples): show LLM action summary in confirmation previews by @smolpaws in #4218
Full Changelog: v1.37.1...v1.38.0
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.37.0...v1.37.1
Lazily hydrate persisted conversations by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/4100
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.36.1...v1.37.0
fix(sdk): rehydrate persisted subscription LLMs by @lufen in https://github.com/OpenHands/software-agent-sdk/pull/4092
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.36.0...v1.36.1
[codex] fix ACP prompt argument order by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/3996
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.35.0...v1.36.0
fix(skills): match keyword triggers on whole words only by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/4008
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.34.0...v1.35.0
ci(version-bump-prs): also open an automation bump PR on SDK release by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/4027
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.33.0...v1.34.0
fix(sdk): release conversation state lock during the async LLM call by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/4009
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.32.0...v1.33.0
Release v1.32.0 by @all-hands-bot in https://github.com/OpenHands/software-agent-sdk/pull/4002
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.31.2...v1.32.0
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.31.1...v1.31.2
chore(ci): use conventional 'chore:' title for typescript-client bump PR by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3971
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.31.0...v1.31.1
feat(profiles): add enable_switch_llm_tool + skill_refs to OpenHandsAgentProfile (#3856, #3868) by @simonrosenberg in https://github.com/OpenHands/sof
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.30.0...v1.31.0
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.29.3...v1.30.0
feat: remove manual workflow_dispatch trigger from run-eval.yml by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/3843
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.29.2...v1.29.3
feat!: remove deprecated DockerWorkspace.mount_dir by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3822
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.29.0...v1.29.2
feat(sdk): deprecate ACPAgentSettings.llm credentials — create_agent no longer reads llm.api_key/base_url by @simonrosenberg in https://github.com/Ope…
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.28.1...v1.29.0
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.28.0...v1.28.1
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.28.0...v1.28.1
fix(sdk): keep OpenHands provider by @enyst in https://github.com/OpenHands/software-agent-sdk/pull/3548
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.27.1...v1.28.0
Patch release on top of v1.27.0.
Patch release on top of v1.27.0.
Cherry-picked onto v1.27.0 for the OpenHands Enterprise release; contains no other changes from main.
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.27.0...v1.27.1
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
app_preferences block to persisted settings by @chuckbutkus in https://github.com/OpenHands/software-agent-sdk/pull/3539misc_settings container by @chuckbutkus in https://github.com/OpenHands/software-agent-sdk/pull/3543Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.26.0...v1.27.0
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.25.0...v1.26.0
feat(sdk): deprecate no-op _return_metrics LLM param (Q1 of #3341) by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3432
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.24.0...v1.25.0
fix(api-breakage): recognize the _DEPRECATED_SDK_EXPORTS registry as a deprecation source by @simonrosenberg in https://github.com/OpenHands/software-…
_DEPRECATED_SDK_EXPORTS registry as a deprecation source by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3402Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.23.1...v1.24.0
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
with state: from stats_callback (deadlock) by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3349Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.23.0...v1.23.1
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
The following merged PRs were labeled release-note-required and are called out explicitly in this release:
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.22.1...v1.23.0
Add SWE-Bench Pro to run-eval workflow by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/2959
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.22.0...v1.22.1
fix: replace deprecated authlib.jose with joserfc by @xingyaoww in https://github.com/OpenHands/software-agent-sdk/pull/3132
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.21.1...v1.22.0
Fix release workflow dispatch token by @xingyaoww in https://github.com/OpenHands/software-agent-sdk/pull/3106
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.21.0...v1.21.1
Remove VERIFIED_TRINITY_MODELS; keep trinity-large-thinking as OpenHands-only by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pul
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.20.1...v1.21.0
fix(sdk): update default critic route by @xingyaoww in https://github.com/OpenHands/software-agent-sdk/pull/3055
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.20.0...v1.20.1
Release v1.19.1 by @all-hands-bot in https://github.com/OpenHands/software-agent-sdk/pull/3019
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.19.1...v1.20.0
chore(deps): bump pypdf from 6.9.2 to 6.10.2 by @dependabot[bot] in https://github.com/OpenHands/software-agent-sdk/pull/2960
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.19.0...v1.19.1
(security fix) validate random branch inputs by @enyst in https://github.com/OpenHands/software-agent-sdk/pull/2621
url field to PluginAuthor to match Claude Code schema by @jpshackelford in https://github.com/OpenHands/software-agent-sdk/pull/2546system_prompt kwarg on Agent by @xingyaoww in https://github.com/OpenHands/software-agent-sdk/pull/2826Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.14.0...v1.19.0
Fix CVE-2026-34444: Update lupa to 2.8 by @aivong-openhands in https://github.com/OpenHands/software-agent-sdk/pull/2925
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.18.0...v1.18.1
feat: Extensions module by @csmith49 in https://github.com/OpenHands/software-agent-sdk/pull/2801
system_prompt kwarg on Agent by @xingyaoww in https://github.com/OpenHands/software-agent-sdk/pull/2826Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.17.0...v1.18.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →