Introduction

"All hands on deck for the future of AI-driven development."

This is the NO.56 article in the "One Open Source Project a Day" series. Today, we are exploring OpenHands (formerly known as OpenDevin).

While projects like RuFlo focus on backend orchestration and cmux on terminal visualization, OpenHands is currently the closest open-source equivalent to a "final form" AI software engineer. It is the community's answer to proprietary tools like Devin. Within a comprehensive GUI environment that integrates a code editor, terminal, browser, and live preview, OpenHands' agents can autonomously plan tasks, execute commands, write code, and verify results—truly achieving a closed loop from requirements to deployment.

What You Will Learn

• What OpenHands is (and the story behind its renaming from OpenDevin).
• How to safely run AI agents in isolated Docker sandboxes.
• Integrating any LLM (GPT-4o, Claude 3.5, Ollama) using LiteLLM.
• How an AI agent handles the entire lifecycle, from bug fixes to feature generation.

Prerequisites

• Basic understanding of AI Agents (Perception-Reasoning-Action loop).
• Basic familiarity with Docker (to run the sandbox environment).
• Access to major LLM API keys or local model environments.

Project Background

Project Introduction

OpenHands is an open-source platform that allows AI agents to work alongside developers. Through a highly interactive web interface, it gives AI agents the ability to manipulate file systems, run terminal commands, and browse the web. The core mission is to make AI-driven software development accessible and fully open. The name "OpenHands" reflects the vision of "All Hands AI"—emphasizing human-AI collaboration and a community-driven approach.

Author/Team Introduction

• Origin: Formerly the OpenDevin community, maintained by researchers from universities like UIUC and CMU, alongside developers worldwide.
• Supporting Organization: All Hands AI.
• Core Philosophy: The future of software development should not be monopolized by closed-source giants but should be shaped by the open-source community.

Project Data

• ⭐ GitHub Stars: 40k+ (Extremely popular top-tier project)
• 📦 Tech Stack: Python (Backend), TypeScript/React (Frontend), Docker (Sandboxing)
• 📄 License: MIT
• 🌐 Repository: OpenHands/OpenHands

Main Features

Core Utility

OpenHands provides a complete "Agent Sandbox." When a user enters a requirement (e.g., "Build a Snake game and fix the current CSS layout bugs"), the system starts a Docker container where the agent:

1. Plans: Breaks down the task into actionable steps.
2. Executes: Creates files, installs dependencies, and writes code.
3. Verifies: Runs tests or starts the application and previews it in the browser.

Use Cases

1. End-to-End Feature Development
   • Build small web applications or backend services from scratch.
2. Autonomous Bug Fixing
   • Provide an agent with a GitHub Issue link and let it autonomously locate the code and submit a PR.
3. Tech Stack Migration / Refactoring
   • Migrate code from JavaScript to TypeScript or perform large-scale code style normalization.

Quick Start

OpenHands strongly recommends running via Docker for security.

# Run the installation/startup script (requires Docker)
docker run -it \
    --pull=always \
    -e SANDBOX_USER_ID=$UID \
    -e WORKSPACE_BASE=$PWD/workspace \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v $PWD/workspace:/opt/workspace \
    -p 3000:3000 \
    --add-host host.docker.internal:host-gateway \
    ghcr.io/openhands/openhands:0.15 # Use the latest version

Once started, visit http://localhost:3000 to configure your API keys and start collaborating via the GUI.

Core Characteristics

1. Highly Interactive GUI
   • Includes a VS Code-style editor, live preview, terminal, and browser, allowing you to witness every move the agent makes.
2. Model Agnostic
   • Supports over 100 LLM providers via the LiteLLM adapter. Switch between premium models like Claude 3.5 Sonnet or fully local ones like Llama 3.
3. Secure Sandboxing
   • All potentially destructive operations (like rm -rf) occur inside an isolated container, protecting your host system.
4. Live App Preview
   • View and interact with the web applications the agent is building directly in the sidebar.
5. MCP (Model Context Protocol) Support
   • Expand agent capabilities with MCP plugins, such as integrating Google Search or Slack messaging.

Project Advantages

Detailed Analysis

1. Software Agent SDK

OpenHands is more than just an application; it provides an SDK that allows developers to customize the "brain" of the agent. You can define different Chain-of-Thought (CoT) strategies or add domain-specific tools, turning the agent into a vertical "expert."

2. SWE-bench Performance

In the ultimate test of AI software engineering—SWE-bench (real GH issue resolution)—OpenHands consistently remains a leader among open-source projects. Its success rate in resolving complex software issues has approached that of proprietary commercial models in several evaluations.

Project Links & Resources

Official Resources

• 🌟 GitHub: https://github.com/OpenHands/OpenHands
• 📘 Official Documentation: https://docs.all-hands.dev/
• 📄 Community Forums: [Check the repo for Slack/Discord links]

Target Audience

• Developers looking to have their own "autonomous AI employee."
• Engineers interested in the cutting edge of AI software engineering research.
• Organizations with high privacy requirements that need to run AI agents in private environments.

Find more useful knowledge and interesting products on my Homepage