Build AI Software Agents with OpenHands: Your Guide to Coding Less & Achieving More

Tired of endless coding? Discover OpenHands, the innovative platform transforming software development. This guide explores how you can leverage OpenHands to build AI-powered software agents that automate tasks, saving you time and boosting productivity. Learn how to run it locally, connect to various LLMs, and join a thriving community.

What is OpenHands? Code Less, Make More!

OpenHands, formerly known as OpenDevin, is a groundbreaking platform that utilizes AI agents to revolutionize software development. These agents are designed to mimic human developers, capable of:

• Modifying Code
• Running Commands
• Browsing the Web
• Calling APIs

The end goal is to dramatically reduce the amount of manual coding required for projects.

Get Started Easily with OpenHands Cloud

The simplest way to begin using OpenHands is through OpenHands Cloud. Enjoy pre-configured settings and $50 in free credits for new users. It's the quickest path to experiencing the power of AI-driven software development without the hassle of local setup.

Run OpenHands Locally with Docker

For those who prefer local control, OpenHands can be run on your system using Docker.

Follow these steps to get started:

1. Pull the latest image:

   docker pull docker.all-hands.dev/all-hands-ai/runtime:0.34-nikolaik
   

   Copy

2. Run the Docker container:

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

   Copy

Once running, access OpenHands at http://localhost:3000.

Important Security Note: If using a public network, consult the Hardened Docker Installation Guide to secure your deployment.

Choosing an LLM Provider for Your AI Agent

After launching, you'll need to select an LLM provider and API key. While Anthropic's Claude 3.5 Sonnet is highly recommended, OpenHands supports a wide variety of options. Experiment to find the best fit for your project!

Explore Other Ways to Run OpenHands

Beyond Docker, OpenHands offers versatile deployment possibilities:

• Connect to your local filesystem for seamless integration.
• Run in a scriptable, headless mode to automate processes.
• Interact via a friendly CLI for convenient command-line control.
• Run on tagged issues using a GitHub action.

For detailed instructions, visit the Running OpenHands documentation.

Addressing Multi-Tenant Environments

OpenHands is primarily designed for single-user workstations. For multi-tenant setups requiring authentication, isolation, and scalability, please contact the OpenHands team for advanced deployment options.

Dive into the Documentation

Comprehensive documentation is available to help you master OpenHands. You'll discover resources on LLM provider usage, troubleshooting, and advanced configurations.

Join the Growing OpenHands Community

Contribute to the OpenHands project and connect with fellow developers through:

• Slack Workspace: Engage in discussions about research, architecture, and future developments.
• Discord Server: A community-run hub for general discussion, questions, and feedback.
• GitHub Issues: Track ongoing projects and suggest your ideas.

Become part of the innovation—your contributions are welcome!