OpenHands: Your Guide to AI-Powered Software Development Agents

Tired of endless coding? Discover OpenHands, the platform empowering AI software development agents to handle coding tasks. This guide will show you how OpenHands can help you code less and achieve more.

Code Less, Make More: What is OpenHands?

OpenHands, formerly OpenDevin, is built around the idea that AI can handle many developer tasks. It leverages AI agents capable of:

• Modifying codebases
• Running commands
• Browsing the internet for information
• Calling APIs
• Copying code snippets from resources like StackOverflow (because we've all been there!)

Essentially, OpenHands aims to equip AI to do what a human developer can do, saving you time and effort with intelligent AI assistance.

Getting Started with OpenHands: Cloud or Local?

OpenHands provides flexible deployment options, allowing usage through a managed cloud service or local instances.

OpenHands Cloud: The Quickest Route

The easiest way to experience OpenHands is through OpenHands Cloud. New users receive $50 in free credits, which allows immediate access to the platform's features.

Running OpenHands Locally: Docker Setup

Alternatively, you can run OpenHands on your local system using Docker. Here's a quick start for running OpenHands locally:

1. Pull the Docker 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

You can access OpenHands at http://localhost:3000. During setup, you'll need to select an LLM provider and provide an API key. Anthropic's Claude 3.5 Sonnet is recommended.

Security Note for Local Deployments

If you're on a public network, make sure to review the Hardened Docker Installation Guide. This secures your deployment by restricting network binding and adding security measures.

Advanced OpenHands Features: Customization and Scripting

Beyond basic usage, OpenHands provides advanced options:

• Local Filesystem Connection: Connect OpenHands to your local files.
• Headless Mode: Run OpenHands in a scriptable, automated environment.
• CLI Interaction: Use a command-line interface for easy control.
• GitHub Actions Integration: Trigger OpenHands on tagged GitHub issues.

Diving Deeper: Documentation and Troubleshooting

Comprehensive documentation is available for those looking to explore OpenHands further. You'll find guidance on LLM providers, troubleshooting tips, and configuration options. If you encounter issues, the Troubleshooting Guide offers practical solutions.

Join the OpenHands Community

OpenHands thrives on community contributions. Here's how to connect:

• Slack Workspace: Discuss research, architecture, and future development.
• Discord Server: A community-driven space for general questions and feedback.
• GitHub Issues: Share your ideas and track ongoing projects.

Find more information in COMMUNITY.md and CONTRIBUTING.md.

License Information

OpenHands is distributed under the MIT License. See LICENSE for details.