Skip to main content

Overview

The Application settings allows you to customize various application-level behaviors in OpenHands, including language preferences, notification settings, custom Git author configuration and more.

Setting Maximum Budget Per Conversation

To limit spending, go to Settings > Application and set a maximum budget per conversation (in USD) in the Maximum Budget Per Conversation field. OpenHands will stop the conversation once the budget is reached, but you can choose to continue the conversation with a prompt.

Git Author Settings

OpenHands provides the ability to customize the Git author information used when making commits and creating pull requests on your behalf. By default, OpenHands uses the following Git author information for all commits and pull requests:
  • Username: openhands
  • Email: openhands@all-hands.dev
To override the defaults:
  1. Navigate to the Settings > Application page.
  2. Under the Git Settings section, enter your preferred Git Username and Git Email.
  3. Click Save Changes
When you configure a custom Git author, OpenHands will use your specified username and email as the primary author for commits and pull requests. OpenHands will remain as a co-author.

Sandbox Grouping Strategy

The Sandbox Grouping Strategy setting controls where OpenHands places new conversations started with your application settings. To change the setting:
  1. Navigate to Settings > Application.
  2. Select a value under Sandbox Grouping Strategy.
  3. Click Save Changes.
Grouping can reduce sandbox startup time and sandbox count. Conversations in one sandbox share its filesystem, credentials, compute limits, and failure domain. The setting does not check whether a sandbox has enough CPU, memory, or disk for another conversation. For API placement and sandbox lifecycle options, see Conversations And Sandboxes.