Hogyan tudom futtatni a teljes kódot?

Megvan minden puzzle darab, úgyhogy most már tényleg életre kelthetjük a rendszert! A korábban elküldött README.md (és az indító szkriptek) alapján a futtatás menete nagyon logikusan, lépésről lépésre van felépítve.

Nyiss egy terminált (parancssort) a VS Code-ban vagy a rendszeredben, és menj a projekt főkönyvtárába (Inventory-AI). Itt vannak a pontos lépések:

1. Előkészületek (Függőségek telepítése)

Először is létre kell hoznunk egy izolált Python környezetet, hogy a projekt csomagjai ne kavarodjanak össze a gépeden lévő többi dologgal.

Futtasd ezeket a parancsokat egymás után:

# 1. Virtuális környezet létrehozása (Python 3.10 ajánlott)
python -m venv .venv

# 2. Virtuális környezet aktiválása
# Windows-on:
.venv\Scripts\activate
# Mac/Linux-on:
source .venv/bin/activate

# 3. Szükséges csomagok telepítése a requirements.txt alapján
pip install -r requirements.txt

2. A "Titkos" Konfiguráció beállítása

A rendszer nem indul el, amíg nem adod meg neki a hozzáféréseket (leginkább az OpenAI kulcsot).

Másold le a .env.example fájlt, és nevezd át simán .env-re.

Nyisd meg a .env fájlt, és töltsd ki az adatokat. Körülbelül így kell kinéznie:

OPENAI_API_KEY=sk-ide-masold-az-openai-kulcsodat
OPENAI_CHAT_MODEL=gpt-4o  # vagy gpt-3.5-turbo
OPENAI_EMBEDDING_MODEL=text-embedding-3-small

# Adatbázis beállítások (ezeket a docker-compose is használni fogja)
DB_HOST=localhost
DB_PORT=5432
DB_NAME=inventory_db
DB_USER=admin
DB_PASSWORD=titkosjelszo

3. Az Adatbázis elindítása (Docker)

Mivel az alkalmazás PostgreSQL-t használ a pgvector kiterjesztéssel, a legegyszerűbb a mellékelt Dockert használni. Győződj meg róla, hogy a Docker asztali alkalmazás fut a gépeden!

Futtasd ezt a terminálban:

docker compose up -d

Mi történik most? A Docker letölti az adatbázis-motort, elindítja a háttérben (-d), és mivel láttuk a konfigurációban, a legelső induláskor automatikusan le is futtatja az init.sql fájlt, létrehozva a táblákat!

4. Az Alkalmazások indítása!

Mivel a rendszered három különálló Gradio felületből áll, dönthetsz, hogy melyiket akarod elindítani.

Ha az adatokat akarod feltölteni (Ezzel érdemes kezdeni):

python scripts/gradio_upload_data.py

Ha csevegni szeretnél az adatokkal:

python scripts/gradio_chat.py

Ha a szöveges leírásokat (dokumentációt) akarod szerkeszteni:

python scripts/gradio_docs.py

Amikor elindítod valamelyiket, a terminálban meg fog jelenni egy link (általában http://127.0.0.1:7860). Csak kattints rá (vagy másold be a böngésződbe), és már használhatod is a felületet!