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.
- Researcher-Agent: durchsucht das Web mit Tavily, arXiv und Co.
- Coder-Agent: führt Python-Code aus, erzeugt Diagramme, wertet Daten aus.
- Reporter-Agent: fasst alles zu einem lesbaren Markdown-Bericht mit Quellen zusammen.
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:
- Einen Computer mit Windows, macOS oder Linux
- Python 3.10 oder neuer (kostenlos von python.org)
- Einen HolySheep AI Account – Jetzt registrieren und du erhältst sofort kostenlose Start-Credits
- Optional: einen Tavily-API-Key für die Websuche (1.000 kostenlose Anfragen pro Monat)
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.
- Gehe auf https://www.holysheep.ai/register und erstelle einen Account.
- Klicke im Dashboard auf „API Keys“ → „Create new key“.
- 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