boc/quixzoom-capture-pipeline/ai-pipeline/GCLOUD-SETUP-GUIDE.md

Google Cloud Setup Guide — Manuella Steg

Steg 1: Skapa Projekt (via Cloud Console)

1. Gå till: https://console.cloud.google.com/
2. Klicka på projekt-väljaren (överst)
3. Klicka "New Project"
4. Namn: QUIXZOOM AI Bootstrap
5. Project ID: quixzoom-ai-bootstrap
6. Klicka "Create"

Steg 2: Aktivera Vision API

1. Gå till: APIs & Services > Library
2. Sök: "Cloud Vision API"
3. Klicka på "Cloud Vision API"
4. Klicka "Enable"

Steg 3: Skapa Service Account

1. Gå till: IAM & Admin > Service Accounts
2. Klicka "Create Service Account"
3. Namn: quixzoom-backend
4. Beskrivning: Backend service for Vision API calls
5. Klicka "Create and Continue"
6. Roll: Cloud Vision User
7. Klicka "Continue"
8. Klicka "Done"

Steg 4: Skapa API-nyckel

1. Gå till: IAM & Admin > Service Accounts
2. Klicka på quixzoom-backend
3. Gå till fliken "Keys"
4. Klicka "Add Key" > "Create New Key"
5. Välj "JSON"
6. Klicka "Create"
7. Spara filen lokalt

Steg 5: Ladda upp nyckeln till server

# På din lokala maskin
scp quixzoom-ai-bootstrap-key.json bernt@bernt.wavult.com:/home/bernt/

Steg 6: Sätt miljövariabler

# På servern
export GOOGLE_APPLICATION_CREDENTIALS="/home/bernt/quixzoom-ai-bootstrap-key.json"
export GOOGLE_CLOUD_PROJECT="quixzoom-ai-bootstrap"

Steg 7: Testa

python3 -c "
from google.cloud import vision
client = vision.ImageAnnotatorClient()
print('✅ Cloud Vision fungerar!')
"

Steg 8: Budgetvarningar

1. Gå till: Billing > Budgets & Alerts
2. Klicka "Create Budget"
3. Namn: QUIXZOOM Vision Budget
4. Budget: 1000 SEK
5. Sätt trösklar: 50%, 80%, 100%
6. Klicka "Create"

Steg 9: Begränsa nycklar

1. Gå till: APIs & Services > Credentials
2. Klicka på din API-nyckel
3. Under "Application restrictions":
   • Välj "IP addresses"
   • Lägg till serverns IP
4. Under "API restrictions":
   • Välj "Restrict key"
   • Välj endast "Cloud Vision API"
5. Klicka "Save"

---

Senast uppdaterad: 2026-06-29