OpenHands/software-agent-sdk

View on GitHub

A clean, modular SDK for building AI agents with OpenHands V1.

Stars: 1.1k
Forks: 539
Open beginner issues: 1
Indexed issues: 267
Avg merge: 1d 19h
Merged PRs (30d): 137

Dominant language: Python
License: MIT
Last GitHub push: Sep 18, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: good first issue help wanted

Beginner friendly Everything

Open All

33 beginner-friendly issues open

[Bug]: TS client drops acp_isolate_data_dir from ACP settings payloads Open

acp bug duplicate-candidate priority:medium ready-for-dev

Difficulty 1/5 Under an hour Newbie friendliness 93/100

OpenHands/software-agent-sdk#5171 · 2 comments · Opened Sep 18, 2026
AttributeError in Telemetry._cache_buckets for providers without prompt caching Open

bug llm priority:medium ready-for-dev sdk

Difficulty 2/5 1-3 hours Newbie friendliness 86/100

OpenHands/software-agent-sdk#5168 · 7 comments · 1 reaction · Opened Sep 18, 2026
Document the invariant: every LLM request must send a system message before the first user message Open

documentation

Difficulty 2/5 1-2 days Newbie friendliness 76/100

OpenHands/software-agent-sdk#5150 · 1 comment · Opened Sep 17, 2026
agent-server profile pre-flight ping: prepend a system message Open

invariants

Difficulty 1/5 Under an hour Newbie friendliness 85/100

OpenHands/software-agent-sdk#5146 · 1 comment · Opened Sep 17, 2026
goal judge: split judge prompt into system + user messages Open

invariants

Difficulty 2/5 1-3 hours Newbie friendliness 86/100

OpenHands/software-agent-sdk#5145 · 1 comment · Opened Sep 17, 2026
Cloud-proxy (TS client) sends upstream body as object -> 422 from /api/cloud-proxy (Pydantic rejects non-string body) Open

bug canvas-extensions javascript priority:medium

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

OpenHands/software-agent-sdk#5138 · 1 comment · Opened Sep 17, 2026
AttributeError: 'PromptTokensDetailsWrapper' object has no attribute 'cache_creation_tokens' in Telemetry._cache_buckets Open

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

OpenHands/software-agent-sdk#5134 · 2 comments · 1 reaction · Opened Sep 17, 2026
[Bug]: Windows PowerShell detection fails when a slow user profile (e.g. conda init) exceeds the probe timeout Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

OpenHands/software-agent-sdk#5133 · 2 comments · Opened Sep 17, 2026
1.48.0: _cache_buckets raises AttributeError on litellm PromptTokensDetailsWrapper Open

bug llm priority:medium release-note-required

Difficulty 2/5 1-3 hours Newbie friendliness 86/100

OpenHands/software-agent-sdk#5099 · 4 comments · Opened Sep 16, 2026
[Bug]: `anyOf: [false, X]` converts to `{"not": {}}`, clobbering the concrete branch Open

bug mcp priority:medium ready-for-dev release-note-required tools

Difficulty 2/5 1-3 hours Newbie friendliness 86/100

OpenHands/software-agent-sdk#5091 · 1 comment · Opened Sep 16, 2026
fix(ts-client): keep Babel override consistent with lockfile Open

bug ci dependencies javascript priority:medium ready-for-dev

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

OpenHands/software-agent-sdk#5072 · 2 comments · Opened Sep 14, 2026
Dockerfile best practice: add --no-install-recommends to apt-get install commands in agent-server Dockerfile Open

docker enhancement good first issue

Difficulty 1/5 Under an hour Newbie friendliness 92/100

OpenHands/software-agent-sdk#5049 · 1 comment · Opened Sep 14, 2026
Dockerfile best practice: specify non-root USER in custom tool example Dockerfile Open

docker enhancement security

Difficulty 1/5 Under an hour Newbie friendliness 90/100

OpenHands/software-agent-sdk#5048 · 1 comment · Opened Sep 14, 2026
[Bug]: Title generation prompt glues user message to instruction and breaks emoji list formatting Open

bug priority:medium ready-for-dev release-note-required sdk

Difficulty 2/5 1-3 hours Newbie friendliness 86/100

OpenHands/software-agent-sdk#4987 · 1 comment · Opened Sep 12, 2026
Behavior test run posts comment with "Integration Tests Results" title Open

bug priority:low testing

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

OpenHands/software-agent-sdk#4944 · 1 comment · Opened Sep 10, 2026
[Feature]: Add acp_isolate_data_dir to ACP_SETTINGS_KEYS in the TypeScript client Open

acp bug javascript priority:medium

Difficulty 1/5 Under an hour Newbie friendliness 88/100

OpenHands/software-agent-sdk#4907 · 1 comment · Opened Sep 8, 2026
[Bug]: RemoteConversation.fork() ignores title in server response; test mocks wrong server shape Open

bug priority:medium ready-for-dev release-note-required sdk

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

OpenHands/software-agent-sdk#4847 · 3 comments · Opened Sep 3, 2026
test_acp_agent.py flakes ~57% of runs: TestACPAgentCleanup counts other agents' _finalize calls Open

bug priority:medium ready-for-dev testing

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

OpenHands/software-agent-sdk#4840 · 2 comments · Opened Sep 3, 2026
ACP: fable missing from Claude Code model picker suggestions Open

acp enhancement ready-for-dev

Difficulty 1/5 Under an hour Newbie friendliness 88/100

OpenHands/software-agent-sdk#4812 · 1 comment · Opened Sep 1, 2026
[Bug]: MessageEvent.visualize returns blank output for an empty TextContent block Open

bug llm priority:low sdk

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

OpenHands/software-agent-sdk#4774 · 2 comments · Opened Aug 30, 2026
[Bug]: HookExecutor converts exit-0 hooks with decision: null into execution failures Open

bug hooks priority:low ready-for-dev

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

OpenHands/software-agent-sdk#4766 · 1 comment · Opened Aug 30, 2026
[Bug]: redact_text_secrets leaves api_key assignments with spaces around = unredacted Open

bug priority:high ready-for-dev sdk security

Difficulty 2/5 1-3 hours Newbie friendliness 85/100

OpenHands/software-agent-sdk#4765 · 1 comment · Opened Aug 30, 2026
[Bug]: OpenAI provider prefix stripped twice for namespaced model IDs in Responses API Open

bug llm priority:medium ready-for-dev sdk

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

OpenHands/software-agent-sdk#4613 · 1 comment · Opened Aug 24, 2026
Isolate MCP OAuth settings persistence in agent-server tests Open

bug mcp priority:medium ready-for-dev security testing

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

OpenHands/software-agent-sdk#4604 · 1 comment · Opened Aug 24, 2026
[Bug]: file editor insert concatenates onto last line when file has no trailing newline Open

bug priority:medium ready-for-dev release-note-required tools

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

OpenHands/software-agent-sdk#4583 · 2 comments · Opened Aug 23, 2026
[Bug]: workspace files return 401 on private-LAN HTTP because the session cookie is rejected Open

bug priority:medium ready-for-dev release-note-required security-related session

Difficulty 2/5 1-3 hours Newbie friendliness 85/100

OpenHands/software-agent-sdk#4562 · 1 comment · Opened Aug 20, 2026
Feature: Expose title_generation_prompt on conversation start request type Open

Difficulty 2/5 1-3 hours Newbie friendliness 74/100

OpenHands/software-agent-sdk#4760 · 1 comment · Opened Aug 20, 2026
[Bug]: `parse_extension_source` duplicates an existing `.git` suffix in GitHub shorthand Open

bug priority:low ready-for-dev sdk

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

OpenHands/software-agent-sdk#4520 · 2 comments · Opened Aug 17, 2026
[Bug]: `Message.to_chat_dict` emits `cache_control` when caching is disabled Open

bug llm priority:medium ready-for-dev

Difficulty 2/5 1-3 hours Newbie friendliness 86/100

OpenHands/software-agent-sdk#4511 · 5 comments · Opened Aug 16, 2026
Incremental view path skips enforce_properties after condensation, leaving orphaned tool_results/tool_uses for the LLM Open

bug condenser-test priority:medium release-note-required

Difficulty 2/5 1-3 hours Newbie friendliness 90/100

OpenHands/software-agent-sdk#4498 · 2 comments · Opened Aug 14, 2026
InstallationManager.update() silently drops pinned refs (should reconcile, not force ref=None) Open

bug plugins priority:medium release-note-required sdk skills Stale

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

OpenHands/software-agent-sdk#4363 · 1 comment · Opened Aug 4, 2026
Deduplicate ConversationStateUpdateEvent definition Open

enhancement

Difficulty 1/5 Under an hour Newbie friendliness 88/100

OpenHands/software-agent-sdk#4736 · 1 comment · Opened Apr 17, 2026
Remove redundant default export from index.ts Open

enhancement

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

OpenHands/software-agent-sdk#4730 · 1 comment · Opened Apr 16, 2026

OpenHands/software-agent-sdk

Get new issues in your inbox