NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #1995 most downloaded on PyPI
OpenHands SDK - Core functionality for building AI agents
Latest stable
1.63.1
Last release 2 days ago
20 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
119 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Add newly released LLM models to verified lists by @all-hands-bot in #6846
Full Changelog: v1.63.0...v1.63.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
chore(deps): bump fastmcp from 4.1.4 to 4.1.6 by @dependabot [bot] in #6735
Note truncated.
chore(deps): bump ruff from 0.13.1 to 0.17.3 by @dependabot [bot] in #6639
Full Changelog: v1.61.0...v1.62.0
refactor(tools): deprecate legacy delegation and move the shared visualizer by @smolpaws in #6510
Full Changelog: v1.60.2...v1.61.0
Hotfix off v1.60.1: cherry-picks #6550 (accept large remote conversation state messages). No other changes.
Hotfix off v1.60.1: cherry-picks #6550 (accept large remote conversation state messages). No other changes.
fix(agent-server): bump Debian snapshot for apt CVE-2026-109518 by @VascoSch92 in #6501
Full Changelog: v1.60.0...v1.60.1
feat(workspace): clone Bitbucket Data Center repositories by @ak684 in #6281
Full Changelog: v1.59.0...v1.60.0
fix(sdk): preserve embedded skill source subpaths by @smolpaws in #6188
Full Changelog: v1.58.2...v1.59.0
fix(security): ship Node.js fixed for CVE-2026-111497 (Brotli) in agent-server images by @ElanHasson in #6200
Full Changelog: v1.58.1...v1.58.2
fix(security): distrust compromised eMudhra/emSign CAs (certifi/pip/uv) by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/6162
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.58.0...v1.58.1
feat(llm): add minimax-m3.1-flash to verified models by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/6101
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.57.0...v1.58.0
feat(agent-server): list the skills a profile launch can load by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/6098
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.56.0...v1.57.0
ci: defer PR artifact cleanup until after merge by @enyst in https://github.com/OpenHands/software-agent-sdk/pull/5998
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.55.1...v1.56.0
fix(agent-server): drop pip's vendored pkg_resources by @aivong-openhands in https://github.com/OpenHands/software-agent-sdk/pull/5991
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.55.0...v1.55.1
refactor(agent-profiles): deprecate the legacy profile resolver by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/5984
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.54.0...v1.55.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.53.0...v1.54.0
fix(skills): exclude installed packages from the user skills scan by @lkshrk in https://github.com/OpenHands/software-agent-sdk/pull/5024
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.52.0...v1.53.0
chore(typescript): agent-server to v1.51.0 by @all-hands-bot in https://github.com/OpenHands/software-agent-sdk/pull/5472
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.51.0...v1.52.0
fix(settings): deprecate ACPAgentSettings.llm so ACP agents keep their metrics LLM by @simonrosenberg in https://github.com/OpenHands/software-agent-s…
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/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: https://github.com/OpenHands/software-agent-sdk/compare/v1.50.0...v1.50.1
fix(deps): bump anyio to 4.14.2 for CVE-2026-63374 by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/5361
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.49.6...v1.50.0
Add Pareto prompt meta-profile routing by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/4287
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.49.5...v1.49.6
chore(tests): remove deprecated gpt-5.2-codex from tests by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/5233
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.49.4...v1.49.5
fix(secret): resolve this server's own LookupSecret URLs in-process by @lkshrk in https://github.com/OpenHands/software-agent-sdk/pull/5026
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.49.3...v1.49.4
feat: register deepseek-v4.1-flash as a verified model by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/4940
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.49.2...v1.49.3
fix(agent-server): preserve legacy conversations in Docker catalogs by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/5128
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.49.1...v1.49.2
fix(agent-server): preserve Docker conversation metadata route by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/5112
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.49.0...v1.49.1
chore(agent-server): remove deprecated desktop URL endpoint past its 1.49.0 deadline by @enyst in https://github.com/OpenHands/software-agent-sdk/pull…
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.48.0...v1.49.0
fix(ci): open PR for merged artifact cleanup by @enyst in https://github.com/OpenHands/software-agent-sdk/pull/4933
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.47.0...v1.48.0
feat(agent-server): add OpenAI Responses gateway by @enyst in https://github.com/OpenHands/software-agent-sdk/pull/4694
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.46.0...v1.47.0
fix(ci): centralize release publication dispatches by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/4886
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/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 https://github.c…
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.44.1...v1.45.0
feat(agent-server): add INSTALL_ACP_PROVIDERS build arg by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/4687
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.44.0...v1.44.1
fix(agent-server): keep crash recovery result on interrupted action branch by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/4488
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.43.1...v1.44.0
chore(deps): bump gitpython from 3.1.50 to 3.1.58 by @dependabot[bot] in https://github.com/OpenHands/software-agent-sdk/pull/4545
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.43.0...v1.43.1
feat(plugin): add Agent Plugins manifest loader (root plugin.json, closed schema) by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pu
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.42.1...v1.43.0
fix(goal): don't halt the goal loop on a STUCK run by @all-hands-bot in https://github.com/OpenHands/software-agent-sdk/pull/4381
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/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 https://github.com/OpenHands/software-agent-sdk/pull/4391
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.41.0...v1.42.0
chore: remove deprecated features past their 1.41.0 removal deadline by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/4394
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.40.1...v1.41.0
chore(sdk): deprecate AgentBase.model_dump_succint by @AzeelSajjad in https://github.com/OpenHands/software-agent-sdk/pull/4328
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.40.0...v1.40.1
Mark deprecated compatibility aliases by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/4004
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.39.1...v1.40.0
chore(release): remove OpenHands Index checklist item by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/4302
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.39.0...v1.39.1
ci: drop unmonitored nightly schedules from integration & examples workflows by @smolpaws in https://github.com/OpenHands/software-agent-sdk/pull/4291
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.38.0...v1.39.0
docs(examples): show LLM action summary in confirmation previews by @smolpaws in https://github.com/OpenHands/software-agent-sdk/pull/4218
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/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
One column per month.