Aca792 commited on
Commit
80851c2
·
1 Parent(s): 4f26a15

README prepravka

Browse files
Files changed (2) hide show
  1. Info.txt +133 -0
  2. README.md +11 -131
Info.txt ADDED
@@ -0,0 +1,133 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # TurBot - Digitalni Asistent za Turističku Agenciju 🤖✈️
2
+
3
+ TurBot je napredni AI asistent za turističke agencije koji pruža precizne informacije o putovanjima na srpskom jeziku. Projekt je razvijen za Challenge 01 i koristi LangChain, Hugging Face modele i RAG (Retrieval Augmented Generation) tehnologiju.
4
+
5
+ ## 🌟 Funkcionalnosti
6
+
7
+ ### Obavezne funkcije:
8
+ - ✅ Pretraga aranžmana po destinaciji (Mediteran, Evropa, Italija, itd.)
9
+ - ✅ Filtriranje po budžetu i veličini porodice
10
+ - ✅ Informacije o specifičnim tipovima aranžmana (all-inclusive)
11
+ - ✅ Preporuke aktivnosti i sadržaja za destinaciju
12
+ - ✅ Odgovori na srpskom jeziku
13
+
14
+ ### Opcionale funkcije (za buduće proširenje):
15
+ - 🔄 Vizuelni sadržaj: slike hotela i destinacija
16
+ - 🔄 Korisničke recenzije: recenzije hotela i atrakcija
17
+ - 🔄 Prognoza vremena: trenutni i kratkoročni uslovi
18
+ - 🔄 Lokalne preporuke: restorani, kulturni objekti, ekskurzije
19
+ - 🔄 Simulacija procesa: rezervacija i plaćanje
20
+
21
+ ## 🛠️ Tehnologije
22
+
23
+ - **LangChain** - Framework za LLM aplikacije
24
+ - **Hugging Face** - Besplatni AI modeli
25
+ - **FAISS** - Vektorska baza podataka
26
+ - **Gradio** - Korisnički interfejs
27
+ - **Python** - Glavni programski jezik
28
+
29
+ ## 📁 Struktura projekta
30
+
31
+ ```
32
+ Izazo/
33
+ ├── src/
34
+ │ ├── main.py # Glavni Gradio interfejs
35
+ │ ├── agent.py # TurBot agent logika
36
+ │ └── rag.py # RAG pipeline
37
+ ├── data/ # Markdown fajlovi sa putovanjima
38
+ ├── vectorstore/ # FAISS vektorska baza
39
+ ├── requirements.txt # Python zavisnosti
40
+ ├── .env # Environment varijable
41
+ └── README.md # Dokumentacija
42
+ ```
43
+
44
+ ## 🚀 Instalacija i pokretanje
45
+
46
+ ### 1. Instalacija zavisnosti
47
+ ```bash
48
+ pip install -r requirements.txt
49
+ ```
50
+
51
+ ### 2. Konfiguracija
52
+ Kreirajte `.env` fajl u root direktorijumu:
53
+ ```
54
+ HUGGINGFACEHUB_API_TOKEN="your_hf_token_here"
55
+ ```
56
+
57
+ ### 3. Priprema podataka
58
+ Stavite vaše markdown fajlove sa putovanjima u `data/` direktorijum, zatim pokrenite:
59
+ ```bash
60
+ python src/rag.py
61
+ ```
62
+
63
+ ### 4. Testiranje agenta
64
+ ```bash
65
+ python test_agent.py
66
+ ```
67
+
68
+ ### 5. Pokretanje aplikacije
69
+ ```bash
70
+ python src/main.py
71
+ ```
72
+
73
+ ## 📝 Primeri pitanja
74
+
75
+ TurBot može odgovoriti na različite tipove pitanja:
76
+
77
+ **Faktička pitanja:**
78
+ - "Koje letnje ponude imate za Mediteran?"
79
+
80
+ **Komparativna pitanja:**
81
+ - "Tražim putovanje u Grčku u junu ili julu za porodicu od četiri osobe, budžet do 2000€."
82
+
83
+ **Specifična pitanja:**
84
+ - "Koji all-inclusive paketi za Tursku su dostupni?"
85
+
86
+ **Preporučna pitanja:**
87
+ - "Preporučite najbolje restorane blizu mog hotela u Rimu."
88
+
89
+ ## 🔧 Konfiguracija
90
+
91
+ ### Modeli
92
+ - **LLM**: HuggingFaceH4/zephyr-7b-beta (besplatni)
93
+ - **Embeddings**: sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2 (podržava srpski)
94
+
95
+ ### Parametri
96
+ - `max_new_tokens`: 512
97
+ - `temperature`: 0.7
98
+ - `top_p`: 0.95
99
+ - `chunk_size`: 500
100
+ - `chunk_overlap`: 50
101
+
102
+ ## 🌐 Deployment
103
+
104
+ ### Hugging Face Spaces
105
+ 1. Kreirajte novi Space na Hugging Face
106
+ 2. Izaberite Gradio kao SDK
107
+ 3. Upload-ujte sve fajlove
108
+ 4. Dodajte HUGGINGFACEHUB_API_TOKEN u Secrets
109
+
110
+ ### Lokalno pokretanje
111
+ ```bash
112
+ python src/main.py
113
+ ```
114
+
115
+ ## 🤝 Doprinos projektu
116
+
117
+ 1. Fork-ujte repository
118
+ 2. Kreirajte feature branch
119
+ 3. Commit-ujte promene
120
+ 4. Push-ujte na branch
121
+ 5. Otvorite Pull Request
122
+
123
+ ## 📄 Licenca
124
+
125
+ Ovaj projekt je razvijen za Challenge 01. Sva prava zadržana.
126
+
127
+ ## 📞 Podrška
128
+
129
+ Za pitanja i podršku, kontaktirajte tim za razvoj.
130
+
131
+ ---
132
+
133
+ **TurBot** - Vaš digitalni partner za putovanja! ✈️🤖
README.md CHANGED
@@ -1,133 +1,13 @@
1
- # TurBot - Digitalni Asistent za Turističku Agenciju 🤖✈️
2
-
3
- TurBot je napredni AI asistent za turističke agencije koji pruža precizne informacije o putovanjima na srpskom jeziku. Projekt je razvijen za Challenge 01 i koristi LangChain, Hugging Face modele i RAG (Retrieval Augmented Generation) tehnologiju.
4
-
5
- ## 🌟 Funkcionalnosti
6
-
7
- ### Obavezne funkcije:
8
- - ✅ Pretraga aranžmana po destinaciji (Mediteran, Evropa, Italija, itd.)
9
- - ✅ Filtriranje po budžetu i veličini porodice
10
- - Informacije o specifičnim tipovima aranžmana (all-inclusive)
11
- - ✅ Preporuke aktivnosti i sadržaja za destinaciju
12
- - ✅ Odgovori na srpskom jeziku
13
-
14
- ### Opcionale funkcije (za buduće proširenje):
15
- - 🔄 Vizuelni sadržaj: slike hotela i destinacija
16
- - 🔄 Korisničke recenzije: recenzije hotela i atrakcija
17
- - 🔄 Prognoza vremena: trenutni i kratkoročni uslovi
18
- - 🔄 Lokalne preporuke: restorani, kulturni objekti, ekskurzije
19
- - 🔄 Simulacija procesa: rezervacija i plaćanje
20
-
21
- ## 🛠️ Tehnologije
22
-
23
- - **LangChain** - Framework za LLM aplikacije
24
- - **Hugging Face** - Besplatni AI modeli
25
- - **FAISS** - Vektorska baza podataka
26
- - **Gradio** - Korisnički interfejs
27
- - **Python** - Glavni programski jezik
28
-
29
- ## 📁 Struktura projekta
30
-
31
- ```
32
- Izazo/
33
- ├── src/
34
- │ ├── main.py # Glavni Gradio interfejs
35
- │ ├── agent.py # TurBot agent logika
36
- │ └── rag.py # RAG pipeline
37
- ├── data/ # Markdown fajlovi sa putovanjima
38
- ├── vectorstore/ # FAISS vektorska baza
39
- ├── requirements.txt # Python zavisnosti
40
- ├── .env # Environment varijable
41
- └── README.md # Dokumentacija
42
- ```
43
-
44
- ## 🚀 Instalacija i pokretanje
45
-
46
- ### 1. Instalacija zavisnosti
47
- ```bash
48
- pip install -r requirements.txt
49
- ```
50
-
51
- ### 2. Konfiguracija
52
- Kreirajte `.env` fajl u root direktorijumu:
53
- ```
54
- HUGGINGFACEHUB_API_TOKEN="your_hf_token_here"
55
- ```
56
-
57
- ### 3. Priprema podataka
58
- Stavite vaše markdown fajlove sa putovanjima u `data/` direktorijum, zatim pokrenite:
59
- ```bash
60
- python src/rag.py
61
- ```
62
-
63
- ### 4. Testiranje agenta
64
- ```bash
65
- python test_agent.py
66
- ```
67
-
68
- ### 5. Pokretanje aplikacije
69
- ```bash
70
- python src/main.py
71
- ```
72
-
73
- ## 📝 Primeri pitanja
74
-
75
- TurBot može odgovoriti na različite tipove pitanja:
76
-
77
- **Faktička pitanja:**
78
- - "Koje letnje ponude imate za Mediteran?"
79
-
80
- **Komparativna pitanja:**
81
- - "Tražim putovanje u Grčku u junu ili julu za porodicu od četiri osobe, budžet do 2000€."
82
-
83
- **Specifična pitanja:**
84
- - "Koji all-inclusive paketi za Tursku su dostupni?"
85
-
86
- **Preporučna pitanja:**
87
- - "Preporučite najbolje restorane blizu mog hotela u Rimu."
88
-
89
- ## 🔧 Konfiguracija
90
-
91
- ### Modeli
92
- - **LLM**: HuggingFaceH4/zephyr-7b-beta (besplatni)
93
- - **Embeddings**: sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2 (podržava srpski)
94
-
95
- ### Parametri
96
- - `max_new_tokens`: 512
97
- - `temperature`: 0.7
98
- - `top_p`: 0.95
99
- - `chunk_size`: 500
100
- - `chunk_overlap`: 50
101
-
102
- ## 🌐 Deployment
103
-
104
- ### Hugging Face Spaces
105
- 1. Kreirajte novi Space na Hugging Face
106
- 2. Izaberite Gradio kao SDK
107
- 3. Upload-ujte sve fajlove
108
- 4. Dodajte HUGGINGFACEHUB_API_TOKEN u Secrets
109
-
110
- ### Lokalno pokretanje
111
- ```bash
112
- python src/main.py
113
- ```
114
-
115
- ## 🤝 Doprinos projektu
116
-
117
- 1. Fork-ujte repository
118
- 2. Kreirajte feature branch
119
- 3. Commit-ujte promene
120
- 4. Push-ujte na branch
121
- 5. Otvorite Pull Request
122
-
123
- ## 📄 Licenca
124
-
125
- Ovaj projekt je razvijen za Challenge 01. Sva prava zadržana.
126
-
127
- ## 📞 Podrška
128
-
129
- Za pitanja i podršku, kontaktirajte tim za razvoj.
130
-
131
  ---
132
 
133
- **TurBot** - Vaš digitalni partner za putovanja! ✈️🤖
 
1
+ ---
2
+ title: Izazo
3
+ emoji: 💬
4
+ colorFrom: yellow
5
+ colorTo: purple
6
+ sdk: gradio
7
+ sdk_version: 5.0.1
8
+ app_file: app.py
9
+ pinned: false
10
+ short_description: RBTHacka Izazov
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
11
  ---
12
 
13
+ An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).