Kapitel 2 · Einrichten und Bedienung

Installation

Bevor wir loslegen, muss Python und marimo auf deinem Computer installiert sein.

💡

Dieser Teil ist für viele Anfänger etwas speziell, da Anweisungen über das Terminal ausgeführt werden müssen. Stell dir einfach vor, dass das Terminal eine Möglichkeit ist direkt mit dem Computer zu reden – statt durch viele Menüs zu klicken, sagst du ihm einfach was er tun soll. Das Terminal ist der App Store für Python-Programme – nur ohne bunte Icons. Für mehr Übung mit den Befehlen gibt es die Seite Terminal Spickzettel. Mit dem Starten von der marimo Anwendung erhälst du die gewohnt Bedienumgebung über einen Webbrowser wieder zurück.

Python installieren

Gehe auf python.org und lade die neueste, stabile Version (z.B. Python 3.13.x) herunter. Wähle immer Python 3.x – nicht Python 2!

Auf macOS empfiehlt sich die Installation über Homebrew : brew install python

Nach der Installation kannst du im Terminal prüfen ob alles geklappt hat:

terminal 
python --version
# oder auf macOS/Linux:
python3 --version

Beispiel:

Ausgabe 
Python 3.13.0
⚠️

Stelle sicher dass du Python zur PATH-Umgebungsvariable hinzufügst – der Installer fragt dich danach. Ohne PATH funktioniert python im Terminal nicht.

Virtuelle Umgebung .venv einrichten und aktivieren

Eine virtuelle Umgebung isoliert die jeweiligen Python-Pakete pro Projekt und so bleiben verschiedene Projekte sauber von einander getrennt.

💡

Es ist gute Praxis für jedes Python-Projekt ein eigenes venv zu erstellen. Die meisten Entwickler machen das automatisch als ersten Schritt.

.venv einrichten

Navigiere zuerst in deinen Projektordner und erstelle dann das .venv:

terminal 
# In den Projektordner wechseln
cd mein-projekt
 
# venv erstellen (erzeugt einen Ordner namens .venv)
python -m venv .venv
# oder auf macOS/Linux:
python3 -m venv .venv
Ausgabe 
# Kein Output bedeutet Erfolg

Der Ordner .venv enthält jetzt eine eigene Python-Installation. Du siehst ihn im Explorer – aber du musst nie darin herumarbeiten.

💡

Nenne den Ordner .venv (mit Punkt) – so erkennen die meisten Editoren und Tools ihn automatisch. Das hilft insbesondere bei Versionsenmanagement Tools.

.venv aktivieren

Das .venv muss in jeder neuen Terminal-Sitzung aktiviert werden:

terminal 
.venv\Scripts\activate
# oder auf macOS/Linux:
source .venv/bin/activate
Ausgabe 
(.venv) mein-projekt $

Der Präfix (.venv) zeigt dir dass die virtuelle Umgebung aktiv ist. Ab jetzt landen alle pip install Befehle im venv – nicht im System.

.venv deactivieren

terminal 
deactivate

Der (.venv) Präfix verschwindet – du bist wieder im normalen System-Python

⚠️

Dies nur zur Info wie du wieder aus der virtellen Umgebung kommst. Für die nächsten Schritt nicht deacitivate ausführen und in der virtuellen Umgebung bleiben.

marimo installieren

Jetzt brauchst du nur noch marimo mit folgendem Befehl im (.venv) zu installiern:

terminal 
python pip install marimo
# oder auf macOS/Linux:
python3 pip install marimo
💡

Wenn die Installation von marimo über pip erfolgreich abgeschlossen ist, können wir die ersten Schritte mit marimo Notebook machen.