پروفایل پروژه

OpenHands

برای agentهای کدنویس، اجرای sandboxed و automation عملی گزینه‌ای قوی است؛ برای chatbot ساده یا یک RAG app مستقل، انتخاب اول نیست.

پروفایل مخزنپلتفرم عامل‌محوربالا
متن‌بازاولویت SDKاجرای sandboxedMCPبازبینی انسانی
مسیر/projects/openhands
نوعپلتفرم عامل‌محور
سطحبالا
شناسه repoOpenHands

OpenHands/OpenHands

پروفایل مستقل برای بررسی پروژه، نه مقاله و نه داشبورد ابزار.

سیگنال‌های سریع

Star77.5k
Fork9.9k
PR199

خلاصهٔ فوری

پلتفرم و SDK برای توسعهٔ عامل‌محور با AI

Star77.5k
Fork9.9k
Commit6,904
Issue139

نمای پروژه

نمای پروژه

چیست

پلتفرم و SDK برای توسعهٔ عامل‌محور با AI

نیست

chatbot ساده یا RAG engine مستقل

مناسب برای

مناسب برای
خودکارسازی کدنویسیاجرای وظایف روی مخزناستقرار چندمحیطی

نامناسب برای

نامناسب برای
فقط پاسخ متنی می‌خواهیدorchestration سبک می‌خواهیدmemory/RAG کامل می‌خواهید

سلامت GitHub

سلامت GitHub

نمایهٔ عمومی GitHub در زمان بررسی: star بالا، issue و PR فعال، و تاریخچهٔ commit بزرگ.

Star77.5k
Fork9.9k
Commit6,904
Issue139
PR199

سطح معماری

سطح معماری

01مدل زبانی

برای تصمیم‌گیری و تولید گام بعدی استفاده می‌شود.

02Agent

منطق اجرا و انتخاب action را پیش می‌برد.

03Conversation

state و history گفتگو را نگه می‌دارد.

04Tool System

ابزارها را به action و observation وصل می‌کند.

05Workspace

محیط اجرای local و remote را abstract می‌کند.

06Security

قبل از اجرا، policy و approval را اعمال می‌کند.

07Observation

خروجی اجرای ابزار را برای گام بعدی برمی‌گرداند.

ماتریس توانمندی Agent

ماتریس توانمندی Agent

Agent loop
قوی

loop اصلی stateless و event-driven است.

Tool calling
قوی

contract اصلی `Action → Observation` است.

Memory / context
خوب

با `Condenser` و conversation state مدیریت می‌شود.

Human review
قوی

confirmation policy رسمی دارد.

Remote execution
قوی

برای local، Docker، VM و Kubernetes آماده است.

جریان اجرا

جریان اجرا / Runtime

1
1. دریافت task

نیاز کاربر وارد `Conversation` می‌شود.

2
2. تصمیم

`Agent` برای گام بعدی تصمیم می‌گیرد.

3
3. ابزار

toolها validate می‌شوند و observation برمی‌گردد.

4
4. ایمنی

policy امنیتی actionهای پرریسک را gate می‌کند.

5
5. ادامه

state و context فشرده برای گام بعدی نگه داشته می‌شود.

ماتریس تناسب

ماتریس تناسب

نگه‌داری repoبالا

برای edit، اجرا و verify روی codebase مناسب است.

بررسی PR و نتیجهٔ اجرای agent

بازبینی کدبالا

tool execution و review gate را کنار هم می‌گذارد.

تایید خروجی و policyهای حساس

triage رخدادبالا

برای بررسی خطا، اجرای command و گزارش عملی ساخته شده است.

تایید علت‌یابی و اقدام نهایی

chatbot سادهکم

سطح پلتفرم و execution آن از نیاز این use case بیشتر است.

انتخاب ابزار سبک‌تر

رادار ریسک

رادار ریسک

Complexityزیاد

stack چندلایه است و onboarding ساده نیست.

Context costمتوسط

بدون condensation درست، هزینهٔ context بالا می‌رود.

Permission riskمتوسط

toolهای اجرایی بدون policy مناسب حساس‌اند.

Positioning driftمتوسط

ممکن است با chatbot یا RAG tool اشتباه گرفته شود.

شواهد

شواهد

منبع رسمیصفحهٔ اصلی
وب‌سایت

positioning رسمی و product surface.

مشاهده منبع
منبع رسمیمخزن GitHub
GitHub

repo رسمی و source of truth عمومی.

مشاهده منبع
منبع رسمیخانهٔ مستندات
مستندات

ورودی اصلی مستندات رسمی.

مشاهده منبع
منبع رسمیفهرست مستندات
مستندات

فهرست صفحات رسمی برای مصرف LLM.

مشاهده منبع
منبع رسمینمای کلی SDK
مستندات

معرفی ساختار و سطح SDK.

مشاهده منبع
منبع رسمیمعماری Agent
مستندات

توضیح reasoning-action loop.

مشاهده منبع
منبع رسمیTool System و MCP
مستندات

تعریف contract ابزارها و integration.

مشاهده منبع
منبع رسمیWorkspace
مستندات

abstraction اجرای local و remote.

مشاهده منبع
منبع رسمیSecurity
مستندات

confirmation policy و action risk.

مشاهده منبع

ارزش یادگیری

ارزش یادگیری

تفکیک Agent، Conversation، Tool System و Workspaceفهم execution امن و sandboxedدیدن confirmation policy در عملیادگیری context compression برای agentهاشناخت surfaceهای محصولی یک پلتفرم عامل‌محور

منابع مرتبط / ابزارها

منابع مرتبط / ابزارها

Project Fit

مناسب چه پروژه‌هایی است؟

این ابزار برای چه پروژه‌هایی مناسب است

OpenHands برای پروژه‌های coding agent و کار روی repo مناسب است

وقتی Agent باید روی کدبیس کار کند، Pull Request بسازد یا چند فایل را هماهنگ تغییر دهد، OpenHands گزینه خوبی است. برای پروژه‌های repo-based و task-driven کاربردی است.

Backend DeveloperAI Agent BuilderFounder فنیAutomation DeveloperSecurity EngineerPython Developer

Audience

به درد چه کسانی می‌خورد؟

Backend DeveloperAI Agent BuilderFounder فنیAutomation DeveloperSecurity EngineerPython Developer

Use Cases

به درد چه پروژه‌هایی می‌خورد؟

Repo Task Agent

برای اجرای تسک روی چند فایل و چند مرحله در کدبیس.

PR Helper

برای آماده‌کردن تغییرها و توضیح دادن نتیجه در PR.

Bug Fix Agent

برای پیدا کردن و رفع باگ‌های تکرارشونده در repo.

Refactor Assistant

برای تغییر ساختار با حداقل ریسک و مسیر مشخص.

Test Runner

برای اجرای تست و جمع کردن نتیجه به شکل قابل خواندن.

Read-only Reviewer

برای مرور کد و پیشنهاد اصلاح بدون اعمال تغییر.

Fit

میزان تناسب با پروژه‌ها

Repo automationعالی
Coding tasksخیلی خوب
PR workflowsخیلی خوب
Single prompt chatمتوسط
UI-only agentضعیف

Flow

چطور ساده پیاده‌سازی می‌شود؟

1مسئله را دقیق کن
2دسترسی repo بده
3تغییر را مرحله‌ای انجام بده
4تست را اجرا کن
5نتیجه را جمع‌بندی کن

Requirements

حداقل پیش‌نیازها

Git repoTest commandAgent permissionsClear taskReview stepRollback plan

Good Fit

چه زمانی انتخاب خوبی است؟

کار روی کدبیس واقعی دارید.
تغییرها چندمرحله‌ای هستند.
خروجی باید قابل review باشد.
تست و PR برایتان مهم است.
می‌خواهید Agent روی repo کار کند.

Bad Fit

چه زمانی انتخاب خوبی نیست؟

فقط یک چت ساده می‌خواهید.
به repo دسترسی ندارید.
وظیفه فقط پاسخ متنی است.
نمی‌خواهید تغییر فایل داشته باشید.
جریان کار بسیار کوتاه و تک‌مرحله‌ای است.

Example

نمونه تصمیم واقعی

برای یک feature کوچک در کدبیس، OpenHands می‌تواند فایل‌ها را پیدا کند، تغییر را مرحله‌ای اعمال کند و نتیجه را برای review آماده کند.