Перейти до вмісту

Документація · Швидкий старт

Початок роботи з 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).

    Terminal

    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, що запускає обидва. Застосунок для комп’ютера робить це за вас.

    Terminal

    git clone https://github.com/this-rs/project-orchestrator.gitcd project-orchestratordocker compose up -d neo4j meilisearch
  3. 3.Запустіть сервер

    За замовчуванням сервер слухає порт 8080 і також віддає вебінтерфейс. Відкрийте http://localhost:8080, щоб переконатися, що він працює.

    Terminal

    orchestrator serve
  4. 4.Підключіть Claude Code через MCP

    Одна команда знаходить Claude Code та додає сервер MCP project-orchestrator у режимі stdio із заздалегідь схваленими інструментами. Інший клієнт MCP може так само запустити mcp_server, а PO_SERVER_URL вказуватиме на ваш сервер. Claude Code — не єдиний рушій: додайте інший (модель, сумісну з OpenAI, Codex або агента ACP, усі в альфі) як провайдера на сторінці «Провайдери» вебінтерфейсу.

    Terminal

    orchestrator setup-claude
  5. 5.Синхронізуйте проєкт і запустіть план

    Зареєструйте свій репозиторій і дайте PO його прочитати. Потім попросіть асистента скласти план. Він викликає інструменти MCP, а ви стежите за завданнями й кроками у вебінтерфейсі.

    Terminal

    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.