Skip to main content
OpenHands is an open-source, model-agnostic AI agent platform for software development that executes real engineering work end-to-end across your codebase. Follow the steps below to connect OpenHands with a model hosted on SambaCloud.

​
Prerequisites

Before starting, ensure you have: If you plan to use Agent Canvas, you also need Node.js 22.12+ and uv.

​
Setup

Follow the steps below to connect OpenHands with a SambaNova model through the settings panel.
1

Open LLM settings in OpenHands

Log in to OpenHands and navigate to Settings.Open the Language Model (LLM) section and click Advanced to reveal the custom model configuration fields.
2

Add SambaNova as a custom model

Enter your SambaNova model using the sambanova/ prefix.Example:
Verify the following settings:
  • Custom Model: sambanova/<model-name>
  • Base URL: https://api.sambanova.ai/v1
  • API Key: Your SambaNova API key
Click Save Changes after completing the configuration.
3

(Optional) Configure an organization-wide default

If you are an OpenHands Cloud organization administrator, you can configure SambaNova as the default model for your team.Navigate to Settings → LLM Profiles and create a new profile using the same:
  • Custom Model
  • Base URL
  • API Key
Set the profile as the organization default. Team members can still override the setting with personal configurations if needed.
4

(Optional) Configure an organization-wide default

If you are an OpenHands Cloud organization administrator, you can configure SambaNova as the default model for your team.Hover over your profile icon in the lower left, select Organization, then select the LLM tab. Configure the same values from Step 2:
  • Custom Model: sambanova/<model-name>
  • Base URL: https://api.sambanova.ai/v1
  • API Key: Your SambaNova API key
Click Save Changes. All organization members will use this LLM configuration unless they configure personal overrides.
5

Start using SambaNova models

Create a new conversation in OpenHands and assign a software engineering task, such as:
  • Find and fix the bug in my Python script
  • Write unit tests for this function
  • Refactor this code to use async/await
OpenHands will use your selected SambaNova model to plan, write code, execute commands, and iterate on solutions.

​
Self-hosted and Docker configuration

If you’re running OpenHands with Docker, configure SambaNova using environment variables:
Open http://localhost:3000 in your browser to access the OpenHands interface. To view logs, run docker logs openhands.
To pin a specific version instead of latest, check the current stable tag on the OpenHands releases page (for example, 1.8.0).

​
Agent Canvas

Agent Canvas is a lightweight local runner for OpenHands that you can install via npm or Docker. Install via npm (requires Node.js 22.12+ and uv – Agent Canvas uses a Python runtime under the hood, managed by uv):
Or run via Docker:
Open http://localhost:8000 in your browser, then navigate to Settings → LLM and configure SambaNova as your provider:
  • Custom Model: sambanova/<model-name> (e.g. sambanova/MiniMax-M2.7)
  • Base URL: https://api.sambanova.ai/v1
  • API Key: Your SambaNova API key

​
Additional resources