Hi Everyone, I was getting started with the hello ...
# questions
p
Hi Everyone, I was getting started with the hello world from the docs https://docs.openhands.dev/sdk/getting-started#step-3:-run-your-first-agent, I am facing the authentication error even though the api key is just created now. Any idea what it could be ?
c
Are you using an Anthropic key or OpenHands provider key? If OpenHands, then please modify the example to have the prefix "openhands/", that is, model is "openhands/claude-sonnet-4-5-20250929"
p
I am using OpenHands, sure will give it a try
Cool works like a charm. May be we can update the docs for the future devs to incorporate this
👍 2
c
Our docs recommends openhands/ but the example assumes anthropic/, we need to fix this @nutritious-balloon-65098 Check the getting-started docs and fix it, rephrase it to be more clear on this, and maybe the other way around: • if the user has a key from an LLM provider, they can use it • they can use OpenHands Cloud provider - and link to where to get an api key, as it already is In case they use OpenHands provider, add to the step to run the script with LLM_MODEL (indicate which exactly) set in env. Verify what I just said.
n
I'm on it! can track my progress here.
Summary of changes just made Scope • Updated SDK docs to fix confusion between anthropic/ and openhands/ model prefixes, and to clearly explain how to run examples with OpenHands Cloud vs a direct provider key. What changed (since my last summary) 1. sdk/getting-started.mdx • Added a Tip block under Step 1 explaining: ◦ Bring-your-own provider key (Anthropic/OpenAI/etc.) → use that provider’s prefix (e.g., anthropic/claude-sonnet-4-5-20250929) ◦ OpenHands Cloud → use openhands/-prefixed models (e.g., openhands/claude-sonnet-4-5-20250929) ◦ Show how to set LLM_MODEL for OpenHands Cloud: export LLM_MODEL="openhands/claude-sonnet-4-5-20250929" • Updated “Run the example” to include: ◦ Direct provider key: run as-is ◦ OpenHands Cloud: export LLM_MODEL then run the script ◦ Added note on what to do if an example hardcodes a model string (replace anthropic/... with openhands/...). 2. sdk/guides/hello-world.mdx • Added the same Tip about provider prefixes and LLM_MODEL. • Split “Running the Example” into: ◦ Direct provider key ◦ OpenHands Cloud with: export LLM_MODEL="openhands/claude-sonnet-4-5-20250929" and a link to get the OpenHands API key. Checklist against your request • Clarify that: ◦ Users can use their own provider key: Done. ◦ They can use OpenHands Cloud and where to get the API key: Done (link included). ◦ If using OpenHands provider, run the script with LLM_MODEL set and indicate which model: Done with explicit export. • Fix mismatch between docs recommending openhands/ and example assuming anthropic/: Addressed by instructions and explicit env var; examples remain synced while the docs now prevent confusion. • Changes are minimal and focused on these points: Yes. Git • Committed locally with a clear message and Co-authored-by. • Pushed to a new branch and opened a draft PR: ◦ Branch: docs/fix-getting-started-llm-prefix ◦ PR: https://github.com/OpenHands/docs/pull/127 Let me know if you want me to: • Mark the PR ready for review, or • Make additional wording tweaks, or • Keep it as draft for now. <sub>View full conversation</sub>
Final summary of new changes What changed since the last summary • Simplified OpenHands Cloud instructions in sdk/getting-started.mdx: ◦ Removed the “two options” text and kept a single, clear run path: export LLM_MODEL="openhands/claude-sonnet-4-5-20250929" uv run python examples/01_standalone_sdk/01_hello_world.py Checklist • Request fully addressed: Yes — there is now only one OpenHands Cloud option, matching that most examples read LLM_MODEL first. • Changes are concise: Yes — minimal edit (1 insertion, 6 deletions) to the relevant section only. • No extraneous modifications: Confirmed. Git • Committed and pushed to the existing branch: ◦ Branch: docs/fix-getting-started-llm-prefix ◦ Commit: a8b5a95 ◦ PR (draft): https://github.com/OpenHands/docs/pull/127 Would you like me to mark the PR ready for review? <sub>View full conversation</sub>
OpenHands encountered an unknown error. See the conversation for more information, or try again <sub>View full conversation</sub>
Final summary New changes since the last summary: none. The branch and draft PR already include the latest updates you requested. Completion checklist • BYO provider first with a concise bash example: done • OpenHands Cloud second with API key link and LLM_MODEL example: done • Simplified OpenHands Cloud to a single run path: done • Clarified provider prefixes (anthropic/ vs openhands/): done • Kept example code using anthropic/ (most users have Anthropic keys): done • Changes are minimal and targeted; no unrelated edits: confirmed Git • Branch: docs/fix-getting-started-llm-prefix • PR (draft): https://github.com/OpenHands/docs/pull/127 If you want, I can now mark the PR ready for review. <sub>View full conversation</sub>