OpenHands: 적게 코딩하고, 더 많이 만들기

Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文

---

AI 기반 소프트웨어 개발 에이전트 플랫폼인 OpenHands(이전 OpenDevin)에 오신 것을 환영합니다.

OpenHands 에이전트는 인간 개발자가 할 수 있는 모든 작업을 수행할 수 있습니다: 코드 수정, 명령 실행, 웹 검색, API 호출, 그리고 네—StackOverflow에서 코드 스니펫을 복사하는 것까지 가능합니다.

자세한 내용은 docs.all-hands.dev에서 확인하거나, 시작하려면 OpenHands Cloud에 가입하세요.

[!IMPORTANT] 업무에 OpenHands를 사용하시나요? 함께 이야기하고 싶습니다! 이 간단한 양식을 작성하여 디자인 파트너 프로그램에 참여하시면 상용 기능을 조기에 이용할 수 있고 제품 로드맵에 대한 의견을 제공할 기회가 주어집니다.

☁️ OpenHands Cloud

OpenHands를 시작하는 가장 쉬운 방법은 OpenHands Cloud를 이용하는 것입니다. 신규 사용자에게는 $50 상당의 무료 크레딧이 제공됩니다.

💻 로컬에서 OpenHands 실행하기

OpenHands는 Docker를 사용하여 로컬 시스템에서도 실행할 수 있습니다. 시스템 요구 사항 및 자세한 정보는 OpenHands 실행 가이드를 참조하세요.

[!WARNING] 공개 네트워크를 사용 중이신가요? 강화된 Docker 설치 가이드를 참조하여 네트워크 바인딩 제한 및 추가 보안 조치를 구현하여 배포를 보호하세요.

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

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

참고: 버전 0.44 이전의 OpenHands를 사용하셨다면, 대화 기록을 새 위치로 마이그레이션하기 위해 mv ~/.openhands-state ~/.openhands 명령을 실행하고 싶을 수 있습니다.

OpenHands는 http://localhost:3000에서 실행됩니다!

애플리케이션을 열면 LLM 제공자를 선택하고 API 키를 추가하라는 메시지가 표시됩니다. Anthropic의 Claude Sonnet 4(anthropic/claude-sonnet-4-20250514)가 가장 잘 작동하지만, 다양한 옵션이 있습니다.

💡 OpenHands를 실행하는 다른 방법들

[!CAUTION] OpenHands는 로컬 워크스테이션에서 단일 사용자가 실행하도록 설계되었습니다. 여러 사용자가 동일한 인스턴스를 공유하는 다중 테넌트 배포에는 적합하지 않습니다. 내장된 인증, 격리 또는 확장성이 없습니다.

다중 테넌트 환경에서 OpenHands를 실행하는 데 관심이 있으시면, 고급 배포 옵션을 위해 저희에게 연락주세요.

로컬 파일 시스템에 OpenHands 연결, 스크립트 가능한 헤드리스 모드로 실행, 친숙한 CLI를 통해 상호 작용, 또는 GitHub 액션으로 태그된 이슈에서 실행할 수도 있습니다.

자세한 정보 및 설정 지침은 OpenHands 실행을 참조하세요.

OpenHands 소스 코드를 수정하려면 Development.md를 확인하세요.

문제가 있으신가요? 문제 해결 가이드가 도움이 될 수 있습니다.

📖 문서

프로젝트에 대한 자세한 정보와 OpenHands 사용 팁은 문서를 확인하세요.

다양한 LLM 제공자 사용 방법, 문제 해결 리소스 및 고급 구성 옵션에 대한 자료를 찾을 수 있습니다.

🤝 커뮤니티 참여 방법

OpenHands는 커뮤니티 주도 프로젝트이며, 모든 분들의 기여를 환영합니다. 대부분의 커뮤니케이션은 Slack을 통해 이루어지므로, 여기가 시작하기에 가장 좋은 장소입니다. 하지만 Discord나 Github에서도 연락을 기다리고 있습니다:

• Slack 워크스페이스 참여 - 연구, 아키텍처 및 향후 개발에 대해 논의합니다.
• Discord 서버 참여 - 일반적인 토론, 질문 및 피드백을 위한 커뮤니티 운영 서버입니다.
• Github 이슈 읽기 또는 게시 - 작업 중인 이슈를 확인하거나 자신의 아이디어를 추가하세요.

커뮤니티에 대한 자세한 내용은 COMMUNITY.md에서 확인하거나, 기여 방법에 대한 세부 사항은 CONTRIBUTING.md에서 찾을 수 있습니다.

📈 진행 상황

월별 OpenHands 로드맵은 여기에서 확인하세요(매월 말 유지 관리자 회의에서 업데이트됨).

📜 라이선스

MIT 라이선스로 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

🙏 감사의 말

OpenHands는 많은 기여자들에 의해 구축되었으며, 모든 기여에 깊은 감사를 드립니다! 또한 다른 오픈 소스 프로젝트를 기반으로 구축되었으며, 그들의 작업에 대해 깊이 감사드립니다.

OpenHands에서 사용된 오픈 소스 프로젝트 및 라이선스 목록은 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},
}