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/z-ai/glm-5.1
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.

Available Models

Model	Custom Model Value
GLM-5.1 ⭐	openai/z-ai/glm-5.1
MiniMax-M2.5	openai/minimax/minimax-m2.5
Kimi-K2.5	openai/moonshotai/kimi-k2.5
MiniMax-M2	openai/minimax/minimax-m2

Tips

• Model selection: GLM-5.1 is recommended for OpenHands due to strong tool calling support
• Context size: OpenHands requires a large context size to work properly
• Cost management: OpenHands will issue many prompts - monitor your usage

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