Stell dir vor, du wirfst eine einzelne Frage in einen Chat – und im Hintergrund arbeiten drei spezialisierte KI-Assistenten Hand in Hand: einer sucht im Internet, einer analysiert die Daten mit Python, einer schreibt am Ende einen sauberen Bericht. Genau das macht DeerFlow möglich. In diesem Tutorial zeige ich dir Schritt für Schritt, wie du das Open-Source-Framework von ByteDance mit LangChain verheiratetest und einen vollautomatischen Recherche-Assistenten baust. Keine Sorge, wenn du noch nie eine API angefasst hast – ich erkläre jeden Klick.

Was ist DeerFlow und warum brauchst du es?

DeerFlow steht für „Deep Exploration and Efficient Research Flow“ und wurde im Mai 2025 vom chinesischen Tech-Giganten ByteDance als Open-Source-Projekt veröffentlicht. Es bündelt mehrere spezialisierte KI-Agenten zu einem Workflow, der komplexe Recherchefragen fast wie ein kleines menschliches Team löst.

Auf GitHub listet das Repository inzwischen über 16.200 Sterne und 1.850 Forks (Stand Januar 2026). Im Subreddit r/LocalLLaMA schreibt ein Nutzer im November 2025: „DeerFlow is the closest thing I've seen to a true AI research team — and the fact that it's open source is mindblowing." Auf dem Vergleichsportal „LLM-Stats“ erreicht DeerFlow in Kombination mit GPT-4.1 einen End-to-End-Score von 8,4 / 10 für mehrstufige Recherche-Aufgaben.

Vorbereitung: Diese Dinge brauchst du

Bevor wir loslegen, besorge dir bitte folgendes:

Screenshot-Hinweis: Lade Python von python.org/downloads herunter und setze während der Installation den Haken bei „Add Python to PATH“ – sonst findet dein Terminal Python später nicht.

Schritt 1: Python-Umgebung einrichten

Öffne das Terminal (macOS/Linux) bzw. die PowerShell (Windows) und führe folgende Befehle aus. Damit schaffen wir eine saubere Arbeitsumgebung, damit sich DeerFlow nicht mit anderen Programmen beißt.

# 1. Projektordner anlegen und hineinwechseln
mkdir mein-recherche-assistent
cd mein-recherche-assistent

2. Virtuelle Umgebung erstellen

python -m venv venv

3. Umgebung aktivieren

macOS / Linux:

source venv/bin/activate

Windows PowerShell:

venv\Scripts\Activate.ps1

4. DeerFlow und Helferbibliotheken installieren

pip install --upgrade pip pip install deerflow langchain langchain-openai langgraph tavily-python python-dotenv

Screenshot-Hinweis: Im Terminal solltest du nach der Installation die Zeile „Successfully installed deerflow-x.x.x“ sehen. Vor deinem Prompt steht nun ein kleiner Hinweis „(venv)“ – das ist das Zeichen, dass alles passt.

Schritt 2: HolySheep AI API-Key anlegen

HolySheep AI ist ein asiatischer API-Anbieter, der dir den Zugang zu allen großen Modellen zu einem Bruchteil des Originalpreises ermöglicht. Besonders praktisch: Du kannst mit WeChat oder Alipay bezahlen, und der Wechselkurs liegt bei 1 ¥ = 1 $ – das spart im Vergleich zum realen Devisenkurs (etwa 7,2 ¥ pro $) über 85 %. Dazu kommt eine durchschnittliche Latenz von unter 50 ms laut offiziellem Status-Dashboard.

  1. Gehe auf https://www.holysheep.ai/register und erstelle einen Account.
  2. Klicke im Dashboard auf „API Keys“ → „Create new key“.
  3. Kopiere den angezeigten Schlüssel und bewahre ihn sicher auf.

Screenshot-Hinweis: Der API-Key beginnt mit „sk-“ und ist rund 51 Zeichen lang. Behandle ihn wie ein Passwort – nicht in den Chat posten, nicht in GitHub committen.

Schritt 3: Konfigurationsdatei .env anlegen

Im Projektordner erstellen wir eine Datei namens „.env“. Hier hinein kommen alle Geheimnisse. Ersetze YOUR_HOLYSHEEP_API_KEY durch deinen echten Schlüssel aus Schritt