Skip to content

Improve LiteLLM proxy docs with screenshot and helpful links #578

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
juanmichelini wants to merge 3 commits into
base: main
Choose a base branch
from
+15 −1
Open

Improve LiteLLM proxy docs with screenshot and helpful links #578

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
0175a99
Add LiteLLM proxy configuration screenshot
openhands-agent Jun 17, 2026
e2cbe1d
Use PNG screenshot for LiteLLM proxy docs
openhands-agent Jun 17, 2026
ce6ce59
Add LiteLLM troubleshooting and usage links
openhands-agent Jun 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 15 additions & 1 deletion openhands/usage/llms/litellm-proxy.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,23 @@ To use LiteLLM proxy with OpenHands, you need to:
* `Base URL` to your LiteLLM proxy URL (e.g. `https://your-litellm-proxy.com`)
* `API Key` to your LiteLLM proxy API key

Here's an example profile configured for a LiteLLM proxy model:

![LiteLLM proxy LLM profile configuration in OpenHands](./screenshots/litellm-proxy-profile-configuration.png)

## Supported Models

The supported models depend on your LiteLLM proxy configuration. OpenHands supports any model that your LiteLLM proxy
is configured to handle.

Refer to your LiteLLM proxy configuration for the list of available models and their names.
For the model names and providers LiteLLM can route, see the [LiteLLM model catalog](https://models.litellm.ai/).
Your OpenHands configuration should use the model name exposed by your LiteLLM proxy.

## Helpful LiteLLM Docs

For common next steps after setup, these LiteLLM docs are especially useful:

- [View supported providers and model names](https://models.litellm.ai/)
- [View usage and spend metrics](https://docs.litellm.ai/docs/proxy/metrics)
- [View proxy request logs in the LiteLLM UI](https://docs.litellm.ai/docs/proxy/ui_logs)
- [Debug proxy issues](https://docs.litellm.ai/docs/proxy/debugging)
Binary file added openhands/usage/llms/screenshots/litellm-proxy-profile-configuration.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading