Vodič za početak

Kako pokrenuti projekt

Pisano korak-po-korak za osobu koja nije programer. Ako negdje zapneš, pogledaj Ako nešto ne radi na dnu.

Na trenutnom računalu je sve već postavljeno. Za svakodnevni rad dovoljno ti je poglavlje „Svaki put kad sjedneš raditi". Ostatak vodiča treba samo pri prebacivanju na novo računalo.

Rječnik pojmova

Pojam	Objašnjenje jednostavno
Python	Programski jezik u kojem je pisan kod projekta. Mora biti instaliran na računalu.
Terminal (PowerShell)	Prozor u koji se upisuju naredbe. Otvori: desni klik na Start → Terminal ili Windows PowerShell.
paket	Dodatak za Python (npr. za rad s kartama). Instaliramo ih popisom iz `requirements.txt`.
`.venv`	„Virtualno okruženje" — zasebna kutija s paketima samo za ovaj projekt, da ne smeta ostatku računala.
Jupyter notebook (`.ipynb`)	Dokument u kojem se kod piše i pokreće po dijelovima (ćelijama), otvara se u web pregledniku.
git	Alat koji pamti povijest izmjena — kao „Track changes" za kod.

Svaki put kad sjedneš raditi

Ovo je sve što ti treba za normalan rad na već postavljenom računalu:

Otvori Terminal (Windows PowerShell).
Uđi u mapu projekta
```
cd C:\GIT\selena
```
Uključi okruženje — mora se pojaviti (.venv) na početku retka:
```
.\.venv\Scripts\Activate.ps1
```
Pokreni Jupyter (otvara se web preglednik s popisom datoteka):
```
jupyter notebook
```

Brža varijanta: umjesto koraka 1–4 samo dvaput klikni datoteku pokreni_jupyter.bat u mapi projekta — ona sve to napravi i otvori Jupyter.

U Jupyteru: ćelija se pokreće s Shift + Enter. Za kraj u terminalu pritisni Ctrl + C.

Prvo postavljanje (samo na novom računalu)

Ovo se radi samo jednom — na trenutnom računalu je već napravljeno. Ponavljaš samo na novom računalu ili ako obrišeš .venv.

1. Instaliraj Python i git

Program	Gdje	Važno
Python 3.12	python.org/downloads	Uključi kvačicu „Add python.exe to PATH" pa Install Now.
Git	git-scm.com	Sve „Next" (zadane postavke). Nije nužan za pokretanje koda.

Provjera: u Terminalu upiši python --version pa git --version — trebaju ispisati broj verzije.

2. Napravi i uključi okruženje

cd C:\GIT\selena
python -m venv .venv
.\.venv\Scripts\Activate.ps1

Ako Windows javi grešku o „execution policy", upiši jednom ovo pa ponovi zadnji redak:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

3. Instaliraj pakete

pip install -r requirements.txt

Skida par stotina MB, može trajati 5–15 min. Sačekaj da se vrati na (.venv) ...>.

4. Provjeri da sve radi

python provjera_okruzenja.py

Ako na kraju piše „SVE RADI", okruženje je spremno. ✅

Ako nešto ne radi

Problem	Rješenje
`python` „not found"	Python nije instaliran ili nije u PATH → ponovi instalaciju i uključi kvačicu „Add to PATH".
Greška „execution policy"	Upiši `Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned` pa pokušaj ponovo.
`(.venv)` se ne pojavi	Nisi u mapi projekta ili nema `.venv` → vrati se na „Prvo postavljanje".
`pip install` puca na `prophet`/`geopandas`	Javi Petru/Claudeu — ti paketi ponekad trebaju dodatni korak na Windowsu.
Notebook javlja „No such file" s `/content/drive/...`	To je stara Google Colab putanja → treba je zamijeniti lokalnom (radimo na tome).

Kad god zapneš: prepiši točan tekst greške i pošalji ga — puno je lakše pomoći s točnim tekstom.