OpenHands 項目詳細介紹

項目概述

OpenHands (原名 OpenDevin) 是一個由 AI 驅動的軟體開發智能體平台。這個開源項目旨在創建能夠像人類開發者一樣工作的 AI 智能體，具備修改代碼、運行命令、瀏覽網頁、調用 API 等全方位的開發能力。

核心特性

🤖 智能體能力

• 代碼修改: 能夠理解和修改現有代碼庫
• 命令執行: 可以運行各種系統命令和腳本
• 網頁瀏覽: 具備瀏覽網頁獲取信息的能力
• API 調用: 能夠調用各種外部 API 接口
• 代碼借鑒: 甚至可以從 StackOverflow 等網站複製代碼片段

🌐 多種部署方式

• 雲端服務: 提供 OpenHands 雲端服務，新用戶可獲得 50 美元免費額度
• 本地 Docker 部署: 支持在本地系統通過 Docker 運行
• 無頭模式: 支持腳本化的無頭模式運行
• 命令行界面: 提供友好的 CLI 交互方式
• GitHub Action: 可以通過 GitHub Action 在標記的 issue 上運行

🔧 技術特點

• 多 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 驅動的自動化開發帶來的便利。