انتقل إلى المحتوى

التوثيق · البدء السريع

ابدأ مع Project Orchestrator

طريقان للبدء: ثبّت تطبيق سطح المكتب بمعالج إعداد يرشدك، أو أعدّ الخادم واربط Claude Code من سطر الأوامر. المتطلبات موضّحة، وكل خطوة على حدة.

اختر طريقك

أريد فقط استخدام التطبيق

ثبّت تطبيق سطح المكتب. يرشدك معالج إعداد، فلا تكتب أي أوامر.

تحتاج إلى ⁦Docker Desktop⁩ وذكاء اصطناعي تتحدث معه: ⁦Claude Code⁩ بحساب ⁦Claude⁩ الخاص بك، أو نموذج آخر تربطه أنت. الذكاء الاصطناعي غير مضمَّن. ⁦Claude Code⁩ هو الخيار الافتراضي والأكثر تجربةً؛ أما المحركات الأخرى فهي في مرحلة ألفا، ويتطلب أي نموذج غير ⁦Claude Code⁩ تفعيل تسجيل الدخول.

  1. ثبّت ⁦Docker Desktop⁩. يمكن للتطبيق مساعدتك في ذلك.
  2. نزّل التطبيق لنظامك وافتحه. على جهاز ⁦Mac⁩ بمعالج ⁦Intel⁩ وإصدار ⁦macOS 10.15⁩ إلى ⁦13.3⁩، خذ ملف ⁦macOS⁩ الأقدم: لا يحتوي على تضمينات محلية، فاستخدم مزوّد تضمينات عبر ⁦HTTP⁩ مثل ⁦Ollama⁩.
  3. اتبع معالج الإعداد. يتحقق من ⁦Docker⁩، ويمكنه تثبيت ⁦Claude Code⁩ إن اخترته، ويشغّل الخدمات. تستغرق المرة الأولى بضع دقائق.

أنا مطوّر

ثبّت الخادم من سطر الأوامر واربط أداتك الخاصة، مثل ⁦Claude Code⁩، عبر ⁦MCP⁩. الخطوات أدناه.

Install what you need, right here

Two things must be on your computer first. Pick your system, download or paste, check, and come back: you never have to leave this page to find an installer.

Docker Desktop

Runs the two services that hold the project memory (Neo4j and Meilisearch).

Open the downloaded .dmg, drag Docker into Applications, then open Docker once and wait for the whale icon to stop moving.

Or in a terminal

brew install --cask docker

Check that it works

Each line should print a version number. If you see « command not found », open a new terminal window and try again.

docker --versiondocker compose version

Docker must be running (open it once) before you start Project Orchestrator. Installation page of the publisher

Claude Code

The assistant Project Orchestrator works with. It uses your own Claude account.

Paste the command in a terminal. It installs everything it needs and asks for your password only if required.

Command

curl -fsSL https://claude.ai/install.sh | bash

Check that it works

Each line should print a version number. If you see « command not found », open a new terminal window and try again.

claude --version

Run claude once to sign in. Installation page of the publisher

خطوات المطوّر: سطر الأوامر

قبل أن تبدأ

Docker
⁦Docker 20.10+⁩ مع ⁦Compose 2.0+⁩، لتشغيل ⁦Neo4j⁩ و⁦Meilisearch⁩
عميل ⁦MCP⁩
⁦Claude Code⁩ أو ⁦Cursor⁩ أو وكيل ⁦OpenAI⁩
مشروع
مستودع شيفرة بإحدى اللغات الـ17 المدعومة
  1. 1.ثبّت المنسّق

    يثبّت ⁦Homebrew⁩ الأمر orchestrator (الخادم) وorch (أداة صغيرة لسطر الأوامر) وmcp_server (الجسر الذي تشغّله أداتك). على ⁦Windows⁩، أو إن فضّلت تطبيقًا، استخدم تطبيق سطح المكتب من قسم التنزيل. على جهاز ⁦Mac⁩ بمعالج ⁦Intel⁩ وإصدار ⁦macOS⁩ أقدم من ⁦13.4⁩، يختار السكربت تلقائيًا الإصدار المخصص لـ⁦macOS⁩ الأقدم (بلا تضمينات محلية: استخدم مزوّد تضمينات عبر ⁦HTTP⁩ مثل ⁦Ollama⁩).

    الطرفية

    brew install this-rs/tap/project-orchestrator# or, without Homebrewcurl -fsSL https://raw.githubusercontent.com/this-rs/project-orchestrator/main/install.sh | sh
  2. 2.شغّل ⁦Neo4j⁩ و⁦Meilisearch⁩

    تعيش ذاكرة المشروع في ⁦Neo4j⁩، ويعمل البحث على ⁦Meilisearch⁩. يتضمن المستودع ملف ⁦compose⁩ يشغّل الاثنين. ويفعل تطبيق سطح المكتب ذلك نيابةً عنك.

    الطرفية

    git clone https://github.com/this-rs/project-orchestrator.gitcd project-orchestratordocker compose up -d neo4j meilisearch
  3. 3.شغّل الخادم

    يستمع الخادم افتراضيًا على المنفذ 8080 ويقدّم واجهة الويب أيضًا. افتح http://localhost:8080 للتأكد من أنه يعمل.

    الطرفية

    orchestrator serve
  4. 4.اربط ⁦Claude Code⁩ عبر ⁦MCP⁩

    أمر واحد يجد ⁦Claude Code⁩ ويضيف خادم ⁦MCP⁩ المسمّى project-orchestrator بنمط ⁦stdio⁩، مع أدواته المعتمدة مسبقًا. ويمكن لعميل ⁦MCP⁩ آخر تشغيل mcp_server بالطريقة نفسها، مع توجيه PO_SERVER_URL إلى خادمك. ليس ⁦Claude Code⁩ المحرك الوحيد: أضف محركًا آخر (نموذجًا متوافقًا مع ⁦OpenAI⁩، أو ⁦Codex⁩، أو وكيل ⁦ACP⁩، وكلها ألفا) بوصفه مزوّدًا في صفحة «المزوّدون» بواجهة الويب.

    الطرفية

    orchestrator setup-claude
  5. 5.زامن مشروعًا وشغّل خطة

    سجّل مستودعك ودع ⁦PO⁩ يقرأه. ثم اطلب من مساعدك خطة. يستدعي أدوات ⁦MCP⁩، وتتابع أنت المهام والخطوات في واجهة الويب.

    الطرفية

    orchestrator sync --path .# then, in Claude Code:> Create a plan to add rate limiting to the public API,> split it into tasks with dependencies, and run it.