Worum es geht
Ein solides Entwicklungs-Setup ist die Grundlage für produktives Arbeiten mit KI-Tools.
Playbook
5. April 2026
Leseführung
Ein solides Entwicklungs-Setup ist die Grundlage für produktives Arbeiten mit KI-Tools.
1Lies zuerst die Einordnung links. Sie erklärt dir, warum der Beitrag überhaupt relevant ist.
2Danach einmal komplett lesen. Der Beitrag ist kurz genug für einen sauberen Durchgang.
3Wenn du tiefer gehen willst, erst am Ende in die Quellen springen.
• Python mit uv — Der neue Standard
• Installation
• Wichtigste uv-Befehle
• Warum uv fuer KI-Projekte?
Ein solides Entwicklungs-Setup ist die Grundlage für produktives Arbeiten mit KI-Tools. 2026 hat sich die Toolchain deutlich modernisiert: uv ersetzt pip/poetry, nvm ist Standard für Node-Versionen, und die GitHub CLI macht tägliche Aufgaben zum Einzeiler.
uv ist ein in Rust geschriebener Python-Package-Manager von Astral (den Machern von ruff). Er ersetzt pip, venv, poetry und pyenv in einem einzigen Werkzeug — und ist dabei 10-100x schneller.
# macOS und Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Homebrew
brew install uv
# Neues Projekt erstellen (inkl. pyproject.toml, .gitignore, git init)
uv init mein-ki-projekt
cd mein-ki-projekt
# Paket hinzufuegen
uv add anthropic openai langchain
# Entwicklungs-Abhaengigkeit hinzufuegen
uv add --dev pytest ruff
# Alle Abhaengigkeiten installieren
uv sync
# Skript ausfuehren (kein manuelles venv-Aktivieren nötig)
uv run python main.py
# Python-Version verwalten
uv python install 3.12
uv python pin 3.12 # Fuer dieses Projekt
# Lock-File fuer reproduzierbare Builds
uv lock
KI-Bibliotheken wie PyTorch, transformers und langchain haben komplexe Dependency-Trees. uv löst diese in Sekunden, wo pip Minuten braucht. Das uv.lock-File garantiert identische Environments in CI/CD und auf dem Produktions-Server.
# pyproject.toml (automatisch generiert von uv)
[project]
name = "mein-ki-projekt"
version = "0.1.0"
requires-python = ">=3.12"
dependencies = [
"anthropic>=0.40.0",
"openai>=1.60.0",
]
[tool.uv]
dev-dependencies = ["pytest>=8.0", "ruff>=0.8"]
nvm (Node Version Manager) ermöglicht die Installation und den Wechsel zwischen beliebigen Node.js-Versionen ohne Root-Rechte.
# macOS und Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# Shell neu laden
source ~/.zshrc
# Node LTS installieren und aktivieren
nvm install --lts
nvm use --lts
Der Schlüssel zu sauberem Versions-Management: Jedes Projekt bekommt eine .nvmrc-Datei:
# Node-Version fuer dieses Projekt festlegen
echo "24" > .nvmrc
# Beim Betreten des Projekts automatisch wechseln
nvm use
Node.js LTS 2026: Node 24 (Krypton) ist die aktuelle LTS-Version, unterstützt bis April 2028.
# In ~/.zshrc einfuegen
autoload -U add-zsh-hook
load-nvmrc() {
local nvmrc_path="$(nvm_find_nvmrc)"
if [ -n "$nvmrc_path" ]; then
nvm use
fi
}
add-zsh-hook chpwd load-nvmrc
Damit wechselt nvm beim cd in ein Verzeichnis mit .nvmrc automatisch die Node-Version.
# Identität setzen
git config --global user.name "Mein Name"
git config --global user.email "mein@email.de"
# Sinnvolle Defaults
git config --global init.defaultBranch main
git config --global pull.rebase false
git config --global core.autocrlf input # Windows: true
# Bessere Diffs
git config --global diff.algorithm histogram
git config --global merge.conflictstyle zdiff3
# Hilfreiche Aliases
git config --global alias.st "status -s"
git config --global alias.lg "log --oneline --graph --all"
Die GitHub CLI (gh) macht Browser-Besuche überflüssig:
# Installation
brew install gh # macOS
winget install GitHub.cli # Windows
# Authentifizieren
gh auth login
# Tägliche Workflows
gh repo create mein-ki-projekt --public # Repo erstellen
gh pr create --title "feat: add AI chat" --body "Beschreibung"
gh pr view --web # PR im Browser öffnen
gh issue list # Offene Issues anzeigen
gh run list # CI/CD Status
gh run watch # Laufenden Build beobachten
2026 ist das Speichern von PyPI-Tokens in GitHub Secrets überholt. Mit Trusted Publishing authentifiziert sich uv publish per kurzlebigem OIDC-Token direkt:
# .github/workflows/publish.yml
jobs:
publish:
permissions:
id-token: write # Fuer Trusted Publishing
steps:
- run: uv build
- run: uv publish # Kein Token nötig!
| Tool | Installation | Zweck |
|---|---|---|
uv |
curl -LsSf https://astral.sh/uv/install.sh | sh |
Python-Pakete, venv, Python-Versionen |
nvm |
curl-Installer von nvm-sh/nvm | Node.js-Versionen per Projekt |
ruff |
uv add --dev ruff |
Linting und Formatting |
gh |
brew install gh |
GitHub-Workflows im Terminal |
git |
vorinstalliert / brew install git |
Versionskontrolle |
Dieses Setup ist in unter 30 Minuten eingerichtet und eliminiert die meisten Umgebungsprobleme, die KI-Projekte verlangsamen. uv und nvm stellen sicher, dass Dependencies und Versionen reproduzierbar sind — auf dem lokalen Rechner, in CI/CD und auf dem Server. Weniger Setup-Aufwand bedeutet mehr Zeit für das eigentliche Projekt.
Nachvollziehbarkeit
Sauberer Abschluss
Wenn du die Kernidee verstanden hast und einen nächsten Schritt für dich benennen kannst, ist der Beitrag für heute erfüllt. Du musst hier nicht alles in einem Zug durcharbeiten.
War dieser Inhalt hilfreich?