OpenHands

Use TensorX models with OpenHands, the open-source AI software developer.

Prerequisites

OpenHands runs as a Docker container. Ensure you have Docker installed and running.

Quick Start

1. Pull and run OpenHands:

docker pull docker.openhands.dev/openhands/runtime:1.0-nikolaik
docker run -it --rm --pull=always \
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.openhands.dev/openhands/runtime:1.0-nikolaik \
    -e LOG_ALL_EVENTS=true \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v ~/.openhands:/.openhands \
    -p 3000:3000 \
    --add-host host.docker.internal:host-gateway \
    --name openhands-app \
    docker.openhands.dev/openhands/openhands:1.0

1. Open http://localhost:3000 in your browser

Configuration

1. When prompted, click "see advanced settings" to open the LLM Settings page

2. Enable the Advanced toggle at the top

3. Configure the following:

Setting	Value
Custom Model	openai/<MODEL_ID>
Base URL	https://api.tensorx.ai/v1
API Key	Your TensorX API key

1. Click Save Settings

Note: The Custom Model format is openai/<model-id>. The openai/ prefix tells OpenHands to use the OpenAI-compatible API format.

Model selection

Call GET /v1/models with your TensorX API key and use one of the returned IDs. If the integration depends on a capability or token limit, query GET /v1/model/info before selecting the model. See Models for examples.

---

Tips

• Model selection: Query GET /v1/model/info and check the capabilities required by the workflow

• Context size: Check the selected model's context metadata before setting a client-side value

• Usage: OpenHands can issue many prompts; monitor usage in the TensorX dashboard

Troubleshooting

Issue	Solution
Empty responses	Check model ID is correct with openai/ prefix
Connection errors	Verify Base URL is https://api.tensorx.ai/v1
Authentication errors	Verify your API key is correct

Resources

• OpenHands Documentation

• OpenHands LLM Configuration

• TensorX API Reference