Von Colab zur lokalen Umgebung

Welche Anpassungen sind nötig, um die Kurs-Notebooks lokal auszuführen?

Inhaltsverzeichnis

  1. Welche Anpassungen sind nötig, um die Kurs-Notebooks lokal auszuführen?
  2. Einmalige Einrichtung
    1. Python-Umgebung & genai_lib
    2. API-Keys einrichten
  3. Anpassungen in der Setup-Zelle
  4. Besonderheiten einzelner Module
  5. Was sich nicht ändert
  6. Kurzcheck vor dem ersten Start
  7. Abgrenzung zu verwandten Dokumenten

Einmalige Einrichtung

Python-Umgebung & genai_lib 

# Virtuelle Umgebung erstellen (empfohlen)
python -m venv .venv
.venv\Scripts\activate        # Windows
source .venv/bin/activate     # Mac/Linux

# genai_lib installieren (ersetzt !uv pip install --system in Colab)
pip install git+https://github.com/ralf-42/Agenten.git#subdirectory=04_modul

API-Keys einrichten

In Colab übernimmt setup_api_keys() die Keys aus dem Colab-Secret-Manager. Lokal müssen die Keys vorab gesetzt werden — am einfachsten über eine .env-Datei im Projektverzeichnis:

# Datei: Agenten/.env
OPENAI_API_KEY=sk-...
LANGSMITH_API_KEY=ls__...

# Alternativ: direkt in der ersten Notebook-Zelle setzen
import os
os.environ["OPENAI_API_KEY"]    = "sk-..."
os.environ["LANGSMITH_API_KEY"] = "ls__..."

.env-Datei niemals in Git einchecken — Eintrag in .gitignore prüfen.

Anpassungen in der Setup-Zelle

Jedes Notebook enthält eine erste Zelle mit Colab-spezifischem Code. Diese drei Zeilen müssen angepasst werden:

Colab-Code Lokal ersetzen durch Aufwand
!uv pip install --system -q <paket> Einmalig im Terminal: pip install <paket> Einmalig
#@title 🔧 Umgebung einrichten{ display-mode: "form" } Zeile löschen Kosmetik
#@markdown <p><font ...>...</font></p> Zeile löschen Kosmetik
get_ipinfo() Zeile auskommentieren Optional

Beispiel: Colab → Lokal

# ❌ Colab (original)
#@title 🔧 Umgebung einrichten{ display-mode: "form" }
!uv pip install --system -q git+https://github.com/ralf-42/Agenten.git#subdirectory=04_modul
from genai_lib.utilities import check_environment, setup_api_keys, mprint, mermaid, show_trace
setup_api_keys(['OPENAI_API_KEY', 'LANGSMITH_API_KEY'])
check_environment()
get_ipinfo()

# ✅ Lokal (angepasst)
from genai_lib.utilities import check_environment, setup_api_keys, mprint, mermaid, show_trace
setup_api_keys(['OPENAI_API_KEY', 'LANGSMITH_API_KEY'])
check_environment()

Besonderheiten einzelner Module

Modul Besonderheit Lokale Anpassung
M08, M09 (RAG) install_packages([...]) für markitdown, unstructured pip install markitdown[all] unstructured[all-docs]
M28 (Gradio) demo.launch(quiet=True) Bleibt unverändert — öffnet automatisch im Browser
M30 (MCP) !uv pip install fastmcp langchain-mcp-adapters pip install fastmcp langchain-mcp-adapters
M09, M15 (Datenbanken) Lokale DB-Dateien (chroma_m09/, m15_checkpoints.db) Werden im Arbeitsverzeichnis angelegt — funktioniert identisch

Was sich nicht ändert

Die Notebooks haben minimale Colab-Abhängigkeiten — der Großteil läuft lokal ohne jede Änderung.

  • ✅ LangSmith-Umgebungsvariablen (os.environ["LANGSMITH_TRACING"] etc.)
  • ✅ Alle LangChain / LangGraph / LangSmith Patterns
  • ✅ Alle relativen Dateipfade (keine /content/-Pfade in den Notebooks)
  • ✅ Kein Google Drive Mounting erforderlich (Notebooks sind selbst-contained)
  • ✅ mprint(), mermaid(), show_trace() aus genai_lib

Kurzcheck vor dem ersten Start

  • Virtuelle Umgebung aktiv? (.venv\Scripts\activate)
  • genai_lib installiert? (pip show genai-lib)
  • API-Keys gesetzt? (echo %OPENAI_API_KEY%)
  • #@title- und get_ipinfo()-Zeilen entfernt?
  • Notebook-spezifische Zusatzpakete installiert (M08, M09, M28, M30)?

Abgrenzung zu verwandten Dokumenten

Dokument Frage
Erste Agenten Wo starte ich als Entwickler mit Von Colab zu Local?
Qualität und Sicherheit Welche Produktionsstandards gelten für Von Colab zu Local?

Version: 1.0
Stand: Mai 2026
Kurs: KI-Agenten. Verstehen. Anwenden. Gestalten.