Skip to main content
OpenHands connects to LithosAI through its OpenAI-compatible LLM client. You do not need to run a separate protocol adapter.

​
Before you begin

Install and start OpenHands, create a key on the API Keys page, and confirm the model ID you want to use on the Models page.
1

Open the LLM settings

Open the OpenHands web interface. In the initial setup dialog, select See advanced settings. If setup is already complete, open Settings, choose LLM, and enable Advanced.
2

Configure LithosAI

Enter the following values:The openai/ prefix selects OpenHands’ OpenAI-compatible client. The remainder must match the model ID shown in the LithosAI console.
OpenHands needs a large context window for its system prompt and tools. Pick a model with enough context for your repository and task.
3

Save and start a session

Select Save Settings, create a workspace, and start a new conversation.

​
Verify the connection

Open a workspace that contains a README.md, then ask OpenHands:
OpenHands should read the workspace file and return its heading. This verifies both the model response and a basic sandbox tool call.

​
Troubleshooting

Issues common to every agent are listed under Common issues.

​
Resources