Socratizer

Online learning platform

Instalacja: Python, Jupyter, pakiety

Instalacja (Python + Jupyter)

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

Co będzie potrzebne (linki)

1) Zainstaluj Pythona (wymagane: 3.14+)

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

Najprościej: pobierz repozytorium jako ZIP lub sklonuj je przez Git.

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

W katalogu kursu uruchom:

uv sync

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)

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 ...).