Ugrás a fő tartalomra

Google AI Studio APP helyi futtatása

 Google AI Studio APP helyi futtatása



Google AI Studio-ban létrehozott minta alkalmazás helyi futtatása (saját gépen).

A legtöbb AI Studio "Build" funkcióval készített app webalkalmazás (általában React/Vite + Node.js alapú), amit ZIP-fájlként exportálhatsz. Ezeket Node.js-sel futtatod helyben.1. Szükséges szoftverek telepítése
  1. Node.js (kötelező)
    • Töltsd le a hivatalos oldalról: https://nodejs.org
    • Válaszd az LTS verziót (ajánlott a stabilitás miatt).
    • Telepítés után nyiss egy terminált/parancssort és ellenőrizd:
      node --version
npm --version
      Ha látod a verziószámokat, rendben van.
  2. Kódszerkesztő (ajánlott)
  3. Git (opcionális, de hasznos)
2. Az app exportálása AI Studio-ból
  1. Nyisd meg az alkalmazásodat az aistudio.google.com-on.
  2. Menj az app preview oldalára.
  3. Keresd a Download App / Export / Download as ZIP gombot (általában jobb felső sarokban).
  4. Töltsd le a ZIP-fájlt és csomagold ki egy mappába (pl. my-ai-app).
3. Helyi futtatás lépései
  1. Nyisd meg a mappát VS Code-ban
    (File → Open Folder → válaszd ki a kicsomagolt mappát).
  2. Telepítsd a függőségeket
    Nyiss terminált a VS Code-ban (Terminal → New Terminal) és írd be:
    npm install
    (Várj, amíg letölti az összes csomagot.)
  3. API kulcs beállítása (nagyon fontos!)
    • Menj az AI Studio-ba → Get API key és hozz létre egy új Gemini API kulcsot.
    • A projekt mappában hozz létre egy .env fájlt (ha nincs), és írd bele:
      GEMINI_API_KEY=ide_írd_az_api_kulcsodat
    • Soha ne commitold ezt a fájlt GitHub-ra!
  4. Indítsd el az alkalmazást
    npm run dev
    (vagy npm start, attól függően, mit tartalmaz a package.json).
  5. Nyisd meg a böngészőben a megadott localhost címet (pl. http://localhost:3000 vagy hasonló).
Gyakori problémák és megoldások
  • "Command not found: npm" → Node.js nincs telepítve vagy nincs a PATH-ban (telepítés után indítsd újra a gépet).
  • Hiányzó .env vagy API key → Az app nem fogja tudni használni a Gemini modellt.
  • Port foglalt → Próbáld npm run dev -- --port 3000 vagy hasonló.
  • Ha Python-os appot exportáltál (ritkább), akkor pip install -r requirements.txt + python app.py.
Alternatívák
  • Exportálhatsz közvetlenül GitHub-ra is az AI Studio-ból.
  • Utána klónozd le és ugyanúgy futtasd.


Figyelem

Ez egy Windows PowerShell biztonsági beállítás miatt van. A rendszer nem engedi a .ps1 szkriptek futtatását (ezért nem indul el az npm).


Ilyenkor nyisd meg a PowerShellt vagy a VS Code terminálját rendszergazdaként (Administrator mód), és add ki ezt a parancsot:powershell

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned


A npm start parancs a production módot indítja (next start), amihez előbb le kell buildelni az alkalmazást.
Jelenleg nincs .next mappa kész build-del, ezért hibát dob.

npm run build
npm start



Fejlesztés közben általában ezt használd  futtatásra (ajánlott):

npm run dev



Hasznos még

npm audit fix --force







Megjegyzések

Megjegyzés küldése