OpenHands는 AI 기반 오픈 소스 소프트웨어 개발 에이전트 플랫폼으로, 인간 개발자처럼 코드를 수정하고, 명령을 실행하고, 웹 페이지를 탐색하고, API를 호출하는 등의 작업을 수행할 수 있습니다.

OpenHands 프로젝트 상세 소개

프로젝트 개요

OpenHands (구 OpenDevin)는 AI 기반 소프트웨어 개발 에이전트 플랫폼입니다. 이 오픈 소스 프로젝트는 인간 개발자처럼 작동할 수 있는 AI 에이전트를 만드는 것을 목표로 하며, 코드 수정, 명령 실행, 웹 페이지 탐색, API 호출 등 모든 개발 능력을 갖추고 있습니다.

핵심 기능

🤖 에이전트 능력

• 코드 수정: 기존 코드베이스를 이해하고 수정할 수 있습니다.
• 명령 실행: 다양한 시스템 명령 및 스크립트를 실행할 수 있습니다.
• 웹 페이지 탐색: 웹 페이지를 탐색하여 정보를 얻을 수 있습니다.
• API 호출: 다양한 외부 API 인터페이스를 호출할 수 있습니다.
• 코드 참조: StackOverflow 등 웹사이트에서 코드 조각을 복사할 수도 있습니다.

🌐 다양한 배포 방식

• 클라우드 서비스: OpenHands 클라우드 서비스를 제공하며, 신규 사용자는 50달러의 무료 크레딧을 받을 수 있습니다.
• 로컬 Docker 배포: 로컬 시스템에서 Docker를 통해 실행할 수 있습니다.
• 헤드리스 모드: 스크립트 기반 헤드리스 모드 실행을 지원합니다.
• 명령줄 인터페이스: 사용자 친화적인 CLI 상호 작용 방식을 제공합니다.
• GitHub Action: GitHub Action을 통해 태그된 이슈에서 실행할 수 있습니다.

🔧 기술 특징

• 다중 LLM 지원: 다양한 대규모 언어 모델을 지원하며, Anthropic's Claude 3.7 Sonnet을 권장합니다.
• Docker 컨테이너화: Docker 기반의 안전한 샌드박스 환경을 제공합니다.
• 파일 시스템 연결: 로컬 파일 시스템에 연결하여 개발할 수 있습니다.
• 커뮤니티 주도: 오픈 소스 커뮤니티 주도 프로젝트이며, 기여를 환영합니다.

빠른 시작

클라우드 배포

OpenHands Cloud에 접속하여 사용을 시작할 수 있으며, 신규 사용자는 50달러의 무료 크레딧을 받습니다.

로컬 Docker 배포

# 런타임 이미지 가져오기
docker pull docker.all-hands.dev/all-hands-ai/runtime:0.36-nikolaik

# OpenHands 실행
docker run -it --rm --pull=always \
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.36-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.36

실행 후 http://localhost:3000에 접속하여 사용할 수 있습니다.

시스템 요구 사항 및 구성

LLM 모델 구성

• 권장 모델: Anthropic's Claude 3.7 Sonnet (anthropic/claude-3-7-sonnet-20250219)
• 다양한 모델 지원: 자세한 내용은 LLM 문서를 참조하십시오.
• API 키: 해당 API 키를 구성해야 합니다.

보안 주의 사항

• 단일 사용자 로컬 워크스테이션에 적합합니다.
• 다중 테넌트 배포에는 적합하지 않습니다.
• 내장된 인증 및 격리 메커니즘이 없습니다.
• 공용 네트워크 배포는 보안 배포 가이드를 참조해야 합니다.

고급 기능

개발자 기능

• 소스 코드 수정: OpenHands 소스 코드 수정을 지원하며, 자세한 내용은 Development.md를 참조하십시오.
• 문제 해결: 자세한 문제 해결 가이드를 제공합니다.
• 고급 구성: 다양한 고급 구성 옵션을 지원합니다.

통합 능력

• 파일 시스템 통합: 로컬 파일 시스템에 연결할 수 있습니다.
• GitHub 통합: GitHub Action 자동화를 지원합니다.
• API 통합: 풍부한 API 호출 능력을 제공합니다.

기술 아키텍처

핵심 구성 요소

• 에이전트 엔진: 핵심 AI 추론 및 의사 결정 엔진
• 샌드박스 환경: 안전한 코드 실행 환경
• 인터페이스 계층: Web UI, CLI, API 등 다양한 상호 작용 방식을 지원합니다.
• 플러그인 시스템: 확장 가능한 플러그인 아키텍처

오픈 소스 생태계

• MIT 라이선스: 오픈 소스 친화적인 라이선스
• 의존 프로젝트: 여러 오픈 소스 프로젝트를 기반으로 구축되었습니다.
• 감사 파일: 모든 의존 프로젝트에 대한 자세한 내용은 CREDITS.md를 참조하십시오.

프로젝트 로드맵

프로젝트 유지 관리자는 매월 말 월간 로드맵을 업데이트하여 프로젝트 개발 방향과 계획을 보여줍니다.

학술 인용

학술 연구에서 이 프로젝트를 인용하려면 다음 형식을 사용하십시오.

@misc{openhands,
title={{OpenHands: An Open Platform for AI Software Developers as Generalist Agents}},
author={Xingyao Wang and Boxuan Li and Yufan Song and Frank F. Xu and Xiangru Tang and Mingchen Zhuge and Jiayi Pan and Yueqi Song and Bowen Li and Jaskirat Singh and Hoang H. Tran and Fuqiang Li and Ren Ma and Mingzhang Zheng and Bill Qian and Yanjun Shao and Niklas Muennighoff and Yizhe Zhang and Binyuan Hui and Junyang Lin and Robert Brennan and Hao Peng and Heng Ji and Graham Neubig},
year={2024},
eprint={2407.16741},
archivePrefix={arXiv},
primaryClass={cs.SE},
url={https://arxiv.org/abs/2407.16741},
}

요약

OpenHands는 AI 지원 소프트웨어 개발의 최전선을 대표하며, 완전한 AI 개발 에이전트 플랫폼을 제공하여 개발자가 다양한 프로그래밍 작업을 보다 효율적으로 완료할 수 있도록 합니다. 개인 개발자든 기업 팀이든 OpenHands를 통해 AI 기반 자동화 개발의 편리함을 경험할 수 있습니다.