Zum Inhalt springen

Doku · Schnellstart

Loslegen mit Project Orchestrator

Zwei Wege zum Start: Desktop-App installieren oder Server einrichten und Claude Code per Befehlszeile verbinden. Voraussetzungen erklärt, Schritt für Schritt.

Wähle deinen Weg

Ich will nur die App nutzen

Installiere die Desktop-App. Ein Einrichtungsassistent führt dich, du tippst also keine Befehle.

Du brauchst Docker Desktop und eine KI zum Reden: Claude Code mit deinem eigenen Claude-Konto oder ein anderes Modell, das du anschließt. Die KI ist nicht enthalten. Claude Code ist der Standard und der am besten erprobte Weg; die anderen Motoren sind in Alpha, und ein anderes Modell als Claude Code setzt eine aktivierte Anmeldung voraus.

  1. Installiere Docker Desktop. Die App kann dir dabei helfen.
  2. Lade die App für dein System herunter und öffne sie. Auf einem Intel-Mac mit macOS 10.15 bis 13.3 nimm die Datei für ältere macOS-Versionen: Sie hat keine lokalen Embeddings, nutze also einen HTTP-Embedding-Anbieter wie Ollama.
  3. Folge dem Einrichtungsassistenten. Er prüft Docker, kann Claude Code installieren, wenn du ihn auswählst, und startet die Dienste. Beim ersten Mal dauert das einige Minuten.

Ich bin Entwickler

Installiere den Server über die Befehlszeile und verbinde dein eigenes Werkzeug, etwa Claude Code, über MCP. Die Schritte stehen unten.

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

Schritte für Entwickler: Befehlszeile

Bevor du anfängst

Docker
Docker 20.10+ mit Compose 2.0+, um Neo4j und Meilisearch zu betreiben
Ein MCP-Client
Claude Code, Cursor oder ein OpenAI-Agent
Ein Projekt
Ein Code-Repository in einer der 17 unterstützten Sprachen
  1. 1.Den Orchestrator installieren

    Homebrew installiert orchestrator (den Server), orch (ein kleines Befehlszeilenwerkzeug) und mcp_server (die Brücke, die dein Werkzeug startet). Unter Windows oder wenn du lieber eine App möchtest, nimm die Desktop-App aus dem Download-Bereich. Auf einem Intel-Mac mit einem System älter als macOS 13.4 wählt das Skript selbst die Version für ältere macOS-Versionen (keine lokalen Embeddings: nutze einen HTTP-Embedding-Anbieter wie 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 und Meilisearch starten

    Das Projektgedächtnis liegt in Neo4j, und die Suche läuft über Meilisearch. Das Repository enthält eine compose-Datei, die beide startet. Die Desktop-App erledigt das für dich.

    Terminal

    git clone https://github.com/this-rs/project-orchestrator.gitcd project-orchestratordocker compose up -d neo4j meilisearch
  3. 3.Den Server starten

    Der Server lauscht standardmäßig auf Port 8080 und liefert auch die Weboberfläche aus. Öffne http://localhost:8080, um zu prüfen, dass er läuft.

    Terminal

    orchestrator serve
  4. 4.Claude Code über MCP verbinden

    Ein Befehl findet Claude Code und fügt den MCP-Server project-orchestrator im stdio-Modus hinzu, mit vorab freigegebenen Werkzeugen. Ein anderer MCP-Client kann mcp_server genauso starten, mit PO_SERVER_URL auf deinen Server. Claude Code ist nicht der einzige Motor: Füge einen weiteren (ein OpenAI-kompatibles Modell, Codex oder einen ACP-Agenten, alle in Alpha) als Anbieter auf der Seite „Anbieter“ der Weboberfläche hinzu.

    Terminal

    orchestrator setup-claude
  5. 5.Ein Projekt synchronisieren und einen Plan ausführen

    Registriere dein Repository und lass PO es lesen. Bitte dann deinen Assistenten um einen Plan. Er ruft die MCP-Werkzeuge auf, und du verfolgst die Aufgaben und Schritte in der Weboberfläche.

    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.