Chuyển đến nội dung

Tài liệu · Bắt đầu nhanh

Bắt đầu với Project Orchestrator

Hai cách bắt đầu: cài ứng dụng máy tính, hoặc thiết lập máy chủ và kết nối Claude Code từ dòng lệnh. Điều kiện cần được giải thích rõ, từng bước một.

Chọn hướng đi của bạn

Tôi chỉ muốn dùng ứng dụng

Cài ứng dụng máy tính. Một trình hướng dẫn thiết lập sẽ dẫn bạn đi, nên bạn không phải gõ lệnh.

Bạn cần Docker Desktop và một AI để trò chuyện: Claude Code với tài khoản Claude của riêng bạn, hoặc một mô hình khác bạn tự kết nối. AI không đi kèm. Claude Code là mặc định và là con đường được thử nhiều nhất; các động cơ khác ở mức alpha, và mô hình không phải Claude Code cần bật đăng nhập.

  1. Cài Docker Desktop. Ứng dụng có thể giúp bạn việc này.
  2. Tải ứng dụng cho hệ điều hành của bạn và mở nó. Trên Mac Intel chạy macOS 10.15 đến 13.3, hãy lấy tệp cho macOS cũ hơn: tệp này không có embedding cục bộ, nên hãy dùng nhà cung cấp embedding qua HTTP như Ollama.
  3. Làm theo trình hướng dẫn thiết lập. Nó kiểm tra Docker, có thể cài Claude Code nếu bạn chọn, và khởi động các dịch vụ. Lần đầu mất vài phút.

Tôi là nhà phát triển

Cài máy chủ từ dòng lệnh và kết nối công cụ của riêng bạn, như Claude Code, qua MCP. Các bước ở bên dưới.

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

Các bước cho nhà phát triển: dòng lệnh

Trước khi bắt đầu

Docker
Docker 20.10+ với Compose 2.0+, để chạy Neo4j và Meilisearch
Một ứng dụng khách MCP
Claude Code, Cursor hoặc một agent OpenAI
Một dự án
Một kho mã, bằng một trong 17 ngôn ngữ được hỗ trợ
  1. 1.Cài trình điều phối

    Homebrew cài orchestrator (máy chủ), orch (một công cụ dòng lệnh nhỏ) và mcp_server (cầu nối mà công cụ của bạn khởi động). Trên Windows, hoặc nếu bạn thích một ứng dụng, hãy dùng ứng dụng máy tính ở phần tải về. Trên Mac Intel chạy macOS cũ hơn 13.4, script tự chọn bản dựng cho macOS cũ hơn (không có embedding cục bộ: hãy dùng nhà cung cấp embedding qua HTTP như 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.Khởi động Neo4j và Meilisearch

    Bộ nhớ dự án nằm trong Neo4j và tìm kiếm chạy trên Meilisearch. Kho mã có sẵn một tệp compose khởi động cả hai. Ứng dụng máy tính làm việc này giúp bạn.

    Terminal

    git clone https://github.com/this-rs/project-orchestrator.gitcd project-orchestratordocker compose up -d neo4j meilisearch
  3. 3.Chạy máy chủ

    Máy chủ lắng nghe ở cổng 8080 theo mặc định và cũng phục vụ giao diện web. Mở http://localhost:8080 để kiểm tra nó đang chạy.

    Terminal

    orchestrator serve
  4. 4.Kết nối Claude Code qua MCP

    Một lệnh tìm Claude Code và thêm máy chủ MCP project-orchestrator ở chế độ stdio, với các công cụ đã được phê duyệt trước. Một ứng dụng khách MCP khác có thể khởi động mcp_server theo cách tương tự, với PO_SERVER_URL trỏ đến máy chủ của bạn. Claude Code không phải động cơ duy nhất: hãy thêm một động cơ khác (mô hình tương thích OpenAI, Codex hoặc tác tử ACP, đều ở mức alpha) làm nhà cung cấp trong trang Nhà cung cấp của giao diện web.

    Terminal

    orchestrator setup-claude
  5. 5.Đồng bộ một dự án và chạy một kế hoạch

    Đăng ký kho mã của bạn và để PO đọc nó. Sau đó nhờ trợ lý của bạn lập một kế hoạch. Nó gọi các công cụ MCP, và bạn theo dõi các tác vụ và bước trong giao diện web.

    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.