OpenHands: Code Less, Make More

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

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

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

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

앱 스크린샷

☁️ OpenHands Cloud

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

💻 로컬에서 OpenHands 실행하기

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

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

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

docker run -it --rm --pull=always \
    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.48-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.48

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

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

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

💡 OpenHands 실행을 위한 다른 방법들

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

다중 테넌트 환경에서 OpenHands를 실행하고 싶다면, 소스 코드가 공개되어 있고 상용 라이선스가 필요한 OpenHands Cloud Helm Chart를 확인해 보세요.

로컬 파일 시스템에 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 파일을 참조하세요.

📚 인용

@inproceedings{
  wang2025openhands,
  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},
  booktitle={The Thirteenth International Conference on Learning Representations},
  year={2025},
  url={https://openreview.net/forum?id=OJd3ayDDoF}
}