Ir para o conteúdo

Docs · Início rápido

Primeiros passos com o Project Orchestrator

Dois jeitos de começar: instalar o app para desktop, ou configurar o servidor e conectar o Claude Code pela linha de comando. Pré-requisitos explicados.

Escolha o seu caminho

Só quero usar o aplicativo

Instale o aplicativo para desktop. Um assistente de configuração guia você, sem precisar digitar comandos.

Você precisa do Docker Desktop e de uma IA para conversar: o Claude Code com a sua própria conta do Claude, ou outro modelo que você conecte. A IA não está incluída. O Claude Code é o padrão e o caminho mais testado; os outros motores estão em alfa, e um modelo diferente do Claude Code exige que o login esteja ativado.

  1. Instale o Docker Desktop. O aplicativo pode ajudar com isso.
  2. Baixe o aplicativo para o seu sistema e abra-o. Em um Mac Intel com macOS 10.15 a 13.3, use o arquivo para macOS mais antigos: ele não tem embeddings locais, então use um provedor de embeddings HTTP como o Ollama.
  3. Siga o assistente de configuração. Ele verifica o Docker, pode instalar o Claude Code se você escolher, e inicia os serviços. A primeira vez leva alguns minutos.

Sou desenvolvedor

Instale o servidor pela linha de comando e conecte a sua própria ferramenta, como o Claude Code, por MCP. Os passos estão abaixo.

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

Passos para desenvolvedores: linha de comando

Antes de começar

Docker
Docker 20.10+ com Compose 2.0+, para executar o Neo4j e o Meilisearch
Um cliente MCP
Claude Code, Cursor ou um agente OpenAI
Um projeto
Um repositório de código, em uma das 17 linguagens compatíveis
  1. 1.Instale o orchestrator

    O Homebrew instala orchestrator (o servidor), orch (uma pequena ferramenta de linha de comando) e mcp_server (a ponte que a sua ferramenta inicia). No Windows, ou se preferir um aplicativo, use o aplicativo para desktop da seção de download. Em um Mac Intel com macOS anterior ao 13.4, o script escolhe sozinho a versão para macOS mais antigos (sem embeddings locais: use um provedor de embeddings HTTP como o 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.Inicie o Neo4j e o Meilisearch

    A memória do projeto fica no Neo4j e a busca roda no Meilisearch. O repositório inclui um arquivo compose que inicia os dois. O aplicativo para desktop faz isso por você.

    Terminal

    git clone https://github.com/this-rs/project-orchestrator.gitcd project-orchestratordocker compose up -d neo4j meilisearch
  3. 3.Execute o servidor

    O servidor escuta na porta 8080 por padrão e também serve a interface web. Abra http://localhost:8080 para verificar se está rodando.

    Terminal

    orchestrator serve
  4. 4.Conecte o Claude Code por MCP

    Um comando encontra o Claude Code e adiciona o servidor MCP project-orchestrator em modo stdio, com as ferramentas pré-aprovadas. Outro cliente MCP pode iniciar o mcp_server do mesmo jeito, com PO_SERVER_URL apontando para o seu servidor. O Claude Code não é o único motor: adicione outro (um modelo compatível com OpenAI, o Codex ou um agente ACP, todos em alfa) como provedor na página Provedores da interface web.

    Terminal

    orchestrator setup-claude
  5. 5.Sincronize um projeto e execute um plano

    Registre o seu repositório e deixe o PO ler. Depois peça um plano ao seu assistente. Ele chama as ferramentas MCP, e você acompanha as tarefas e os passos na interface 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.