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

267 open issues indexed

[Feature]: Add OCI Generative AI provider support Open

enhancement priority:normal ready-for-dev

Difficulty 4/5 3-5 days Newbie friendliness 48/100

OpenHands/software-agent-sdk#5188 · 2 comments · Opened Sep 19, 2026
[Bug]: DeepSeek V4.x reasoning_effort and output cap depend on proxy metadata (dropped without it, 384K default cap with it; openai/ ignores overrides) Open

bug llm priority:high ready-for-dev

Difficulty 4/5 3-5 days Newbie friendliness 52/100

OpenHands/software-agent-sdk#5181 · 2 comments · Opened Sep 18, 2026
Suspend idle Docker conversation runtimes after terminal states Open

enhancement priority:high ready-for-dev

Difficulty 4/5 3-5 days Newbie friendliness 48/100

OpenHands/software-agent-sdk#5177 · 3 comments · Opened Sep 18, 2026
docs(review): consolidate repository-specific review checkpoints Open

enhancement ready-for-dev

Difficulty 4/5 3-5 days Newbie friendliness 55/100

OpenHands/software-agent-sdk#5175 · 1 comment · Opened Sep 18, 2026
[Bug]: SDK sends unsupported reasoning_effort to MiniMax M3 Open

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

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

OpenHands/software-agent-sdk#5173 · 2 comments · Opened Sep 18, 2026
[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
[Bug]: Codex ACP on a headless host: `authenticate("chat-gpt")` does not complete within `ACP_AUTH_TIMEOUT` although Codex is logged in ("ChatGPT authentication did not complete in time") Open

acp bug priority:medium

Difficulty 4/5 3-5 days Newbie friendliness 48/100

OpenHands/software-agent-sdk#5167 · 1 comment · Opened Sep 18, 2026
Agent Plugins: submit OpenHands for the Compatible Clients page Open

enhancement plugins ready-for-dev

Difficulty 4/5 3-5 days Newbie friendliness 34/100

OpenHands/software-agent-sdk#5159 · 2 comments · Opened Sep 17, 2026
Unlocked installs resolve browser-use 0.11.13 with mcp 2.x — browser tools silently disappear Open

bug dependencies mcp priority:high ready-for-dev tools

Difficulty 4/5 3-5 days Newbie friendliness 52/100

OpenHands/software-agent-sdk#5152 · 1 comment · Opened Sep 17, 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
condenser hard context reset: preserve the leading system prompt instead of summarizing it at offset 0 Open

invariants

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

OpenHands/software-agent-sdk#5149 · 1 comment · Opened Sep 17, 2026
condenser: ensure the SystemPromptEvent is never forgotten (keep_first=0 / summary-first edge case) Open

invariants

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

OpenHands/software-agent-sdk#5148 · 1 comment · Opened Sep 17, 2026
GraySwan analyzer: guarantee system message first when history window drops the SystemPromptEvent Open

invariants

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

OpenHands/software-agent-sdk#5147 · 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
Ensure a system message always precedes the first user message in LLM requests Open

invariants

Difficulty 5/5 Over a week Newbie friendliness 35/100

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

architecture enhancement llm memory

Difficulty 3/5 1-2 days Newbie friendliness 73/100

OpenHands/software-agent-sdk#5142 · 1 comment · Opened Sep 17, 2026
[Agent Profile] The `default` profile and named profiles build different agents — collapse launch into one pipeline Open

architecture enhancement ready-for-dev

Difficulty 5/5 Over a week Newbie friendliness 25/100

OpenHands/software-agent-sdk#5141 · 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
[Bug]: Gemini edit corrupts non-UTF-8 content during unrelated edits Open

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

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

OpenHands/software-agent-sdk#5108 · 1 comment · Opened Sep 16, 2026
[Bug]: Profile pre-flight validation reports budget-exceeded keys as valid and blocks ~2 min on retries Open

bug llm performance priority:medium ready-for-dev

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

OpenHands/software-agent-sdk#5100 · 5 comments · Opened Sep 16, 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]: FileEditor replaces symlinks instead of updating the target file Open

bug priority:medium ready-for-dev tools

Difficulty 4/5 3-5 days Newbie friendliness 68/100

OpenHands/software-agent-sdk#5096 · 1 comment · Opened Sep 16, 2026
[Bug]: ACP session/load failure silently starts a fresh session without restoring conversation context Open

acp bug priority:high session

Difficulty 4/5 3-5 days Newbie friendliness 55/100

OpenHands/software-agent-sdk#5094 · 2 comments · Opened Sep 16, 2026
WAITING_FOR_CONFIRMATION: any user message implicitly approves pending actions on next run() Open

bug priority:high ready-for-dev sdk security

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

OpenHands/software-agent-sdk#5092 · 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
[Feature]: Add a lightweight remote conversation control client Open

enhancement ready-for-dev

Difficulty 4/5 3-5 days Newbie friendliness 55/100

OpenHands/software-agent-sdk#5080 · 1 comment · Opened Sep 15, 2026
TaskTool child remains running and task mapping is lost after Agent Server process restart Open

agent-execution bug priority:high tools

Difficulty 5/5 Over a week Newbie friendliness 35/100

OpenHands/software-agent-sdk#5074 · 1 comment · Opened Sep 14, 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
model-router: drop silent default_model fallback; fail loudly (retryable) on no match Open

enhancement llm sdk tools

Difficulty 4/5 3-5 days Newbie friendliness 58/100

OpenHands/software-agent-sdk#5068 · 2 comments · Opened Sep 14, 2026
[Bug]: RemoteConversation attach does not restore tool registrations Open

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

Difficulty 4/5 3-5 days Newbie friendliness 68/100

OpenHands/software-agent-sdk#5067 · 1 comment · 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
Allow profile-scoped script commands without a conversation Open

enhancement ready-for-dev

OpenHands/software-agent-sdk#5044 · 2 comments · 1 assignee · Opened Sep 14, 2026
Enforce behavioral parity between Python and TypeScript SDK clients Open

ci enhancement ready-for-dev sdk

Difficulty 5/5 Over a week Newbie friendliness 45/100

OpenHands/software-agent-sdk#5043 · 1 comment · Opened Sep 14, 2026
[Bug]: UTF-8 Chinese text misclassified as binary when sampling splits a multibyte character Open

bug priority:medium release-note-required tools

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

OpenHands/software-agent-sdk#5038 · 1 comment · Opened Sep 14, 2026
Recover a conversation after the TypeScript client loses its create response Open

enhancement javascript sdk

OpenHands/software-agent-sdk#5035 · 1 comment · 1 assignee · Opened Sep 14, 2026
Security: requesting a private disclosure channel Open

documentation question security

Difficulty 4/5 3-5 days Newbie friendliness 30/100

OpenHands/software-agent-sdk#5034 · 2 comments · 1 reaction · Opened Sep 14, 2026
fix: preserve repository identity in PR linked-issue readiness checks Open

bug ci priority:medium ready-for-dev

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

OpenHands/software-agent-sdk#5027 · 2 comments · Opened Sep 13, 2026
[Bug]: LookupSecret self-deadlocks the agent-server event loop on loopback resolution Open

bug priority:high ready-for-dev sdk security

OpenHands/software-agent-sdk#5025 · 1 comment · 1 assignee · Opened Sep 13, 2026
[Bug]: Installed skill resources leak into permanent context even when disabled Open

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

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

OpenHands/software-agent-sdk#5023 · 1 comment · Opened Sep 13, 2026
Move Canvas conversation stream transport into the TypeScript SDK Open

architecture canvas-extensions enhancement ready-for-dev security

OpenHands/software-agent-sdk#5012 · 2 comments · 1 assignee · Opened Sep 12, 2026
Allow trusted orchestrators to provision only a selected runtime session credential Open

enhancement ready-for-dev

Difficulty 4/5 3-5 days Newbie friendliness 55/100

OpenHands/software-agent-sdk#5007 · 2 comments · Opened Sep 12, 2026
Release Docker conversation runtimes without deleting audit history Open

docker enhancement ready-for-dev release-note-required

Difficulty 4/5 3-5 days Newbie friendliness 55/100

OpenHands/software-agent-sdk#5004 · 3 comments · Opened Sep 12, 2026
Remove legacy Cloud MISSING archive fallback Open

enhancement javascript sdk

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

OpenHands/software-agent-sdk#5002 · 1 comment · Opened Sep 12, 2026
[Bug]: Conversations stall indefinitely when ChatGPT subscription LLM call hangs Open

bug llm priority:high ready-for-dev security

OpenHands/software-agent-sdk#4997 · 1 comment · 1 assignee · Opened Sep 12, 2026
[Feature]: Normalize Agent Server and legacy Cloud conversation lifecycle in TypeScript Open

enhancement ready-for-dev

OpenHands/software-agent-sdk#4996 · 1 comment · 1 assignee · Opened Sep 12, 2026

OpenHands/software-agent-sdk

Get new issues in your inbox