Instalacja (Python + Jupyter)

Poniższe kroki pozwalają uruchomić notatniki kursowe lokalnie na własnym komputerze.

Co będzie potrzebne (linki)

• Python: https://www.python.org/
• Jupyter (Notebook/JupyterLab): https://jupyter.org/install
• Jupyter Widgets (ipywidgets): https://ipywidgets.readthedocs.io/
• uv: https://docs.astral.sh/uv/
• Komponent plikowy: Plik środowiska (pyproject.toml)
• Komponent plikowy: Lockfile (uv.lock)

Szybki start bez repo (ze strony WWW)

1. Pobierz oba pliki: pyproject.toml oraz uv.lock do jednego katalogu.
2. W tym katalogu uruchom:

uv sync --frozen

1) Zainstaluj Pythona (wymagane: 3.14+)

• Oficjalne instalatory: https://www.python.org/downloads/
• Po instalacji sprawdź w terminalu:

python --version

Jeśli system ma kilka wersji Pythona, upewnij się, że python wskazuje na właściwą (lub używaj python3).

2) Zainstaluj uv (menedżer środowiska i zależności)

Instrukcja instalacji (Windows/macOS/Linux): https://docs.astral.sh/uv/

Po instalacji sprawdź:

uv --version

3) Pobierz materiały kursu

Pobierz z tej sekcji dwa komponenty typu plik. Do odtworzenia środowiska wystarczą: - pyproject.toml - uv.lock

4) Zainstaluj zależności (reproducja dzięki uv.lock)

W katalogu kursu uruchom:

uv sync --frozen

To tworzy środowisko .venv i instaluje dokładnie te wersje pakietów, na których powstały notatniki.

Pakiety używane w notatnikach (instalują się przez uv sync --frozen)

• numpy, pandas
• scipy
• statsmodels
• matplotlib, seaborn
• (opcjonalnie, do części interaktywnych) ipywidgets

5) Uruchom Jupyter Notebook / JupyterLab

W katalogu kursu:

uv run jupyter lab

albo (klasyczny interfejs):

uv run jupyter notebook

6) Jupyter Widgets (ipywidgets) — interaktywne elementy w notatnikach

W kilku notatnikach występują elementy interaktywne (suwaki, listy wyboru). Jeśli widżety nie wyświetlają się i pojawia się komunikat o braku ipywidgets, doinstaluj je w środowisku kursu:

uv run python -m pip install ipywidgets

W razie dalszych problemów: sprawdź, czy uruchamiasz notatnik w tym samym środowisku, które utworzył uv sync (czyli przez uv run ...).