GUI

​

Prerequisites

• OpenHands is running

​

Overview

​

Initial Setup

1. Upon first launch, you’ll see a settings popup.
2. Select an LLM Provider and LLM Model from the dropdown menus. If the required model does not exist in the list, select see advanced settings. Then toggle Advanced options and enter it with the correct prefix in the Custom Model text box.
3. Enter the corresponding API Key for your chosen provider.
4. Click Save Changes to apply the settings.

​

Settings

You can use the Settings page at any time to:

• Setup the LLM provider and model for OpenHands.
• Setup the search engine.
• Configure MCP servers.
• Connect to GitHub and connect to GitLab.
• Set application settings like your preferred language, notifications and other preferences.
• Manage custom secrets.

​

GitHub Setup

OpenHands automatically exports a GITHUB_TOKEN to the shell environment if provided:

​

GitLab Setup

OpenHands automatically exports a GITLAB_TOKEN to the shell environment if provided:

​

BitBucket Setup

​

Advanced Settings

The Advanced settings allows configuration of additional LLM settings. Inside the Settings page, under the LLM tab, toggle Advanced options to access additional settings.

• Custom Model: Use the Custom Model text box to manually enter a model. Make sure to use the correct prefix based on litellm docs.
• Base URL: Specify a Base URL if required by your LLM provider.
• Memory Condensation: The memory condenser manages the LLM’s context by ensuring only the most important and relevant information is presented.
• Confirmation Mode: Enabling this mode will cause OpenHands to confirm an action with the user before performing it.

​

Key Features

For an overview of the key features available inside a conversation, please refer to the Key Features section of the documentation.

​

Status Indicator

The status indicator located in the bottom left of the screen will cycle through a number of states as a new conversation is loaded. Typically these include:

• Disconnected : The frontend is not connected to any conversation.
• Connecting : The frontend is connecting a websocket to a conversation.
• Building Runtime... : The server is building a runtime. This is typically in development mode only while building a docker image.
• Starting Runtime... : The server is starting a new runtime instance - probably a new docker container or remote runtime.
• Initializing Agent... : The server is starting the agent loop (This step does not appear at present with Nested runtimes).
• Setting up workspace... : Usually this means a git clone ... operation.
• Setting up git hooks : Setting up the git pre commit hooks for the workspace.
• Agent is awaiting user input... : Ready to go!

​

Tips for Effective Use

• Be specific in your requests to get the most accurate and helpful responses, as described in the prompting best practices.
• Use one of the recommended models, as described in the LLMs section.

​

Other Ways to Run Openhands

• Run OpenHands in a scriptable headless mode.
• Run OpenHands with a friendly CLI.
• Run OpenHands on GitHub issues with a GitHub action.