Neues Python-Projekt im Terminal anlegen – Schritt für Schritt

1. Projektordner erstellen und öffnen

mkdir mein-projekt
cd mein-projekt

mkdir = erstellt den Ordner, cd = wechselt hinein.

2. Python-Version prüfen

python3 --version

Zeigt dir, welche Python-Version installiert ist (sollte 3.10+ sein für moderne Projekte, z.B. FastAPI).

3. Virtuelle Umgebung (venv) anlegen

Eine virtuelle Umgebung isoliert die Pakete deines Projekts von deinem restlichen System – immer empfohlen.

python3 -m venv venv

Das erstellt einen Ordner venv/ mit einer eigenen, sauberen Python-Installation nur für dieses Projekt.

4. Virtuelle Umgebung aktivieren

Mac/Linux:

source venv/bin/activate

Windows (falls relevant):

venv\Scripts\activate

Wenn es funktioniert hat, steht (venv) vor deiner Terminal-Zeile:

(venv) nalan@MacBook mein-projekt %

Zum Deaktivieren später einfach:

deactivate

5. Pakete installieren

pip install fastapi uvicorn

Mehrere Pakete gleichzeitig sind mit Leerzeichen getrennt möglich.

Installierte Pakete anzeigen:

pip list

6. requirements.txt erstellen (Paketliste festhalten)

Damit andere (oder du auf einem anderen Rechner/Server) genau dieselben Pakete installieren können:

pip freeze > requirements.txt

Später installieren (z.B. auf dem Server) mit:

pip install -r requirements.txt

7. Grundstruktur des Projekts anlegen

touch main.py
touch README.md
touch .gitignore
mkdir tests

Typische Struktur danach:

mein-projekt/
├── venv/
├── main.py
├── README.md
├── .gitignore
├── requirements.txt
└── tests/

8. .gitignore befüllen (wichtig!)

Damit die venv/-Ordner & Co. nicht ins Git-Repo landen:

echo "venv/
__pycache__/
*.pyc
.env
.DS_Store" > .gitignore

9. Git-Repository initialisieren

git init
git add .
git commit -m "Initial commit"

Mit GitHub verbinden (falls du dort ein leeres Repo erstellt hast):

git remote add origin https://github.com/dein-username/mein-projekt.git
git branch -M main
git push -u origin main

10. Projekt starten / testen

Einfaches Python-Skript ausführen:

python3 main.py

Falls FastAPI-Projekt:

uvicorn main:app --reload

Kompletter Ablauf im Überblick (Copy-Paste-Vorlage)

mkdir mein-projekt
cd mein-projekt
python3 -m venv venv
source venv/bin/activate
pip install fastapi uvicorn
pip freeze > requirements.txt
touch main.py README.md .gitignore
echo "venv/
__pycache__/
*.pyc
.env" > .gitignore
git init
git add .
git commit -m "Initial commit"

Merksatz

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

Das ist der Kreislauf, den du bei fast jedem Python-Projekt wiederholst. Wenn du (venv) nicht in der Terminal-Zeile siehst, ist die Umgebung nicht aktiv – dann source venv/bin/activate nicht vergessen.