📚 Uputstvo za korištenje projekta: autosuggestion

Jednostavni vodič za potpune početnike

---

🧠 Što ovaj program radi?

Ova aplikacija koristi umjetnu inteligenciju (Naivni Bayes algoritam) za automatske prijedloge teksta.
Pokreće se lokalno na vašem računalu putem web preglednika (na adresi http://localhost:5000).

---

✅ Što vam treba?

• Windows računalo
• Instaliran Python 3
• Internetska veza za prvo pokretanje
• Volja za učenjem – nema potrebe za programerskim znanjem!

---

🔽 1. Kako preuzeti projekt (.zip)

1. Otvorite ovu stranicu u pregledniku:
   https://github.com/ssjelkovec/autosuggestion
2. Kliknite na zeleni gumb “Code” (gore desno).
3. Odaberite “Download ZIP”.
4. Kada se preuzme, desni klik na zip datoteku → “Extract All...” (Izdvoji sve...).
5. Otvorite izdvojenu mapu (vjerojatno se zove autosuggestion-main).

---

🗃️ 2. Priprema mapa i datoteka

1. U otvorenoj mapi autosuggestion-main, napravite novu mapu nazvanu db.
2. U tu db mapu kopirajte datoteku sve.txt. Nju preuzmite ovdje.

---

🖥️ 3. Pokretanje CMD-a (Command Prompt)

1. Na tipkovnici pritisnite Windows tipku.
2. Upišite cmd, pa kliknite desnim klikom i odaberite “Run as administrator” (Pokreni kao administrator).
3. Otvorit će vam se crni prozor — to je Command Prompt.

---

📁 4. Kako koristiti cd i pronaći mapu projekta

📌 Što je cd?

cd znači change directory – koristi se za ulazak u određenu mapu (kao da “otvarate mapu” u terminalu).

📌 Kako pronaći točan path (putanju)?

1. Otvorite File Explorer (Windows + E).
2. Pronađite mapu gdje ste otpakirali projekt, npr. autosuggestion-main.
3. Kliknite u adresnu traku na vrhu prozora (gdje piše Desktop, Downloads...).
4. Kopirajte tu putanju, npr.:

C:\Users\Ivana\Desktop\autosuggestion-main

📌 Kako upotrijebiti cd?

U CMD-u upišite:

cd C:\Users\Ivana\Desktop\autosuggestion-main

Ako putanja sadrži razmake, koristite navodnike:

cd "C:\Users\Ivana\My Projects\autosuggestion-main"

---

🧪 5. Stvaranje i aktivacija virtualnog okruženja

Stvaranje okruženja:

python -m venv venv

(Ako javlja grešku, probajte s py -3 -m venv venv)

Aktivacija:

venv\Scripts\activate

Ako sve ide kako treba, na početku linije će pisati nešto poput (venv).

---

📦 6. Instalacija Flask biblioteke

Kopirajte i zalijepite sljedeće u cmd:

pip install Flask

Time instalirate potrebnu biblioteku za pokretanje servera.

---

🚀 7. Pokretanje programa

Kad je sve spremno i virtualno okruženje aktivno:

flask run

Ako sve radi ispravno, vidjet ćete poruku poput:

Running on http://127.0.0.1:5000

---

🌐 8. Otvorite aplikaciju

1. Otvorite bilo koji internet preglednik (Chrome, Edge, Firefox...).
2. Upišite u adresnu traku:

http://localhost:5000

3. Otvorit će se sučelje za automatsku sugestiju teksta!

---

❌ 9. Zaustavljanje programa

U cmd-u pritisnite:

CTRL + C

To će zaustaviti Flask server.

---

⚠️ 10. Česti problemi

Problem	Mogući uzrok / rješenje
python nije prepoznat	Provjerite da imate instaliran Python i da je dodan u “PATH”
flask nije prepoznat	Zaboravili ste aktivirati virtualno okruženje (venv\Scripts\activate)
sve.txt nedostaje	Mora se nalaziti u mapi db, unutar projekta
Ne vidi sugestije	Provjerite je li datoteka sve.txt ispravno formatirana i na pravom mjestu

---

🔁 11. Svaki put kad želite pokrenuti ponovno

1. Otvorite cmd
2. Uđite u mapu:

   cd C:\Users\Ivana\Desktop\autosuggestion-main
   

3. Aktivirajte environment:

   venv\Scripts\activate
   

4. Pokrenite:

   flask run
   

---

Sretno! Ako se pojavi greška, slobodno pitajte za pomoć s točnim tekstom greške.