Knowledge Hub

Learning Journey

Python-Projekt im Terminal

Schritt für Schritt: Ordner, venv, pip, requirements.txt, .gitignore, Git und Start — im selben Guide-Bereich wie die Terminal-Grundlagen.

Gesamtfortschritt

0%

Nächster Schritt: Projektordner und Python prüfen

  1. 01

    Projektordner und Python prüfen

    Neuen Ordner anlegen, hineingehen und prüfen, ob Python 3.10+ installiert ist.

    Offen · 2 Themen
    Öffnen
    • Einen Projektordner mit `mkdir` und `cd` anlegen
    • Die lokale Python-Version mit `python3 --version` prüfen
    mkdircdpython3 --version

    Projektordner erstellen und öffnen

    Lesson · Anleitung · 3 min

    `mkdir` erstellt den Ordner, `cd` wechselt hinein.

    • `mkdir mein-projekt` legt den Ordner an
    • `cd mein-projekt` macht ihn zum aktuellen Verzeichnis

    Python-Version prüfen

    Lesson · Anleitung · 2 min

    `python3 --version` zeigt die Installation — für moderne Projekte (z. B. FastAPI) sollte 3.10+ stehen.

    • `python3 --version` ausführen
    • Ziel: Python 3.10 oder neuer

  2. 02

    Virtuelle Umgebung

    Pakete pro Projekt isolieren: venv anlegen, aktivieren und später deaktivieren.

    Offen · 2 Themen
    Öffnen
    • Eine venv mit `python3 -m venv venv` erzeugen
    • Aktivieren auf Mac/Linux erkennen (`(venv)` in der Prompt-Zeile)
    venvactivatedeactivate

    venv anlegen

    Lesson · Anleitung · 4 min

    Eine virtuelle Umgebung isoliert Pakete vom System — immer empfohlen.

    • `python3 -m venv venv` erstellt den Ordner `venv/`
    • Darin liegt eine eigene, saubere Python-Installation für dieses Projekt

    venv aktivieren

    Lesson · Anleitung · 5 min

    Mac/Linux: `source venv/bin/activate`. Erfolg: `(venv)` vor der Terminal-Zeile.

    • Mac/Linux: `source venv/bin/activate`
    • Windows: `venv\Scripts\activate`
    • Erfolg: `(venv)` steht vor dem Prompt, z. B. `(venv) nalan@MacBook mein-projekt %`
    • Später: `deactivate` beendet die Umgebung

  3. 03

    Pakete und requirements.txt

    Abhängigkeiten installieren und mit `pip freeze` reproduzierbar festhalten.

    Offen · 2 Themen
    Öffnen
    • Pakete in der aktiven venv installieren
    • `requirements.txt` schreiben und später wieder einspielen
    pip installpip listpip freeze

    Pakete installieren

    Lesson · Anleitung · 5 min

    Beispiel: FastAPI und Uvicorn. Mehrere Pakete mit Leerzeichen trennen.

    • `pip install fastapi uvicorn`
    • `pip list` zeigt installierte Pakete

    requirements.txt erstellen

    Lesson · Anleitung · 4 min

    `pip freeze` hält exakte Versionen fest — wichtig für Server und andere Rechner.

    • `pip freeze > requirements.txt` schreibt die Paketliste
    • Später: `pip install -r requirements.txt`

  4. 04

    Projektstruktur und .gitignore

    Startdateien anlegen und `venv/` plus Caches aus Git heraushalten.

    Offen · 2 Themen
    Öffnen
    • Typische Dateien und den `tests/`-Ordner anlegen
    • `.gitignore` so setzen, dass venv und Secrets nicht committed werden
    touchmkdir.gitignore

    Grundstruktur anlegen

    Lesson · Anleitung · 4 min

    `main.py`, `README.md`, `.gitignore` und `tests/` — plus `venv/` und `requirements.txt`.

    • `touch main.py README.md .gitignore`
    • `mkdir tests`
    • Zielbaum: venv/, main.py, README.md, .gitignore, requirements.txt, tests/

    .gitignore befüllen

    Lesson · Anleitung · 3 min

    venv, Bytecode, `.env` und macOS-`.DS_Store` gehören nicht ins Repo.

    • `venv/`, `__pycache__/`, `*.pyc` ignorieren
    • `.env` nie committen — Secrets bleiben lokal
    • Optional: `.DS_Store`

  5. 05

    Git und Projekt starten

    Repo initialisieren, optional mit GitHub verbinden, dann Skript oder Uvicorn starten.

    Offen · 2 Themen
    Öffnen
    • `git init`, ersten Commit und optional Remote/Push machen
    • Ein Skript oder FastAPI lokal starten
    git initgit remotepython3uvicorn

    Git-Repository initialisieren

    Lesson · Anleitung · 6 min

    Lokales Repo anlegen; bei vorhandenem leeren GitHub-Repo Remote setzen und pushen.

    • `git init` → `git add .` → `git commit -m "Initial commit"`
    • `git remote add origin https://github.com/dein-username/mein-projekt.git`
    • `git branch -M main` und `git push -u origin main`

    Projekt starten / testen

    Practice · Anleitung · 4 min

    Einfaches Skript mit `python3 main.py`, FastAPI mit `uvicorn main:app --reload`.

    • `python3 main.py` für ein Skript
    • `uvicorn main:app --reload` für FastAPI (Auto-Reload)

  6. 06

    Workflow-Vorlage

    Copy-Paste-Ablauf und der Merksatz für jedes neue Python-Projekt.

    Offen · 2 Themen
    Öffnen
    • Den Komplettablauf einmal durchspielen können
    • Den Kreislauf venv → pip → freeze → commit erinnern
    Copy-PasteMerksatzvenv

    Kompletter Ablauf im Überblick

    Practice · Anleitung · 5 min

    Von `mkdir` über venv, pip, freeze, Dateien und `.gitignore` bis zum ersten Commit.

    • Ordner + `python3 -m venv venv` + `source venv/bin/activate`
    • `pip install fastapi uvicorn` und `pip freeze > requirements.txt`
    • `touch` / `.gitignore` / `git init` / erster Commit

    Merksatz

    Bridge · Anleitung · 1 min

    venv aktivieren → Pakete installieren → requirements.txt aktualisieren → git commit

    • Das ist der Kreislauf bei fast jedem Python-Projekt
    • Siehst du `(venv)` nicht in der Terminal-Zeile, ist die Umgebung nicht aktiv — dann `source venv/bin/activate`
Terminal-Grundlagen