dotenv.template

# GenMedia Creative Studio - Environment Variables Template
# Copy this file to .env and fill in the required values.
#
# Usage:
#   cp .env.template .env
#   # Edit .env with your specific configuration

# ==============================================================================
# 🌍 Core Infrastructure & Environment
# ==============================================================================

# [REQUIRED] The Google Cloud Project ID where resources (Vertex AI, Firestore, Storage) are located.
PROJECT_ID=

# [OPTIONAL] The default GCP region for most services (Vertex AI, etc.).
# Default: us-central1
# LOCATION=us-central1
# GEMINI_TTS_LOCATION=global

# [OPTIONAL] Defines the environment (e.g., 'dev', 'prod').
# Used to load environment-specific content files like config/about_content.{env}.json.
# Default: "" (empty)
# APP_ENV=

# [OPTIONAL] The base URL for the application's backend APIs.
# Default: http://localhost:8080 (or based on PORT)
# API_BASE_URL=http://localhost:8080

# [OPTIONAL] The port the application server listens on.
# Default: 8080
# PORT=8080

# [OPTIONAL] The email of the service account used for authentication.
# Required if running in an environment where default credentials are insufficient.
# SERVICE_ACCOUNT_EMAIL=

# [OPTIONAL] Google Analytics Measurement ID for tracking user interactions.
# GA_MEASUREMENT_ID=

# [OPTIONAL] Require every non-health request to contain a trusted upstream user header.
# Default: true outside local/dev/test APP_ENV values, false for local/dev/test.
# REQUIRE_AUTHENTICATED_USER=true

# [OPTIONAL] Comma-separated trusted headers to read authenticated user email from.
# Defaults support Google IAP plus oauth2-proxy/Netskope style headers:
# X-Goog-Authenticated-User-Email,X-Auth-Request-Email,X-Forwarded-Email,X-Email,X-Authenticated-User
# AUTH_EMAIL_HEADERS=

# ==============================================================================
# 🧠 Gemini Models (Text & Multimodal)
# ==============================================================================

# [OPTIONAL] The primary Gemini model used for general text and reasoning tasks.
# Default: gemini-3.5-flash
# MODEL_ID=gemini-3.5-flash

# [OPTIONAL] The endpoint used for Gemini text/multimodal calls. Gemini 3.x models
# are NOT served from single regions such as us-central1 (requests 404); keep this
# at "global" — or a us/eu multi-region — independently of LOCATION.
# Default: global
# GEMINI_LOCATION=global

# [OPTIONAL] The specific model used for image generation features.
# Default: gemini-3.1-flash-image
# GEMINI_IMAGE_GEN_MODEL=gemini-3.1-flash-image

# [OPTIONAL] The region for the Gemini Image Generation API.
# Default: global
# GEMINI_IMAGE_GEN_LOCATION=global

# [OPTIONAL] Base URL for Gemini Image Gen API if using a proxy or non-standard endpoint.
# GEMINI_IMAGE_GEN_API_BASE_URL=

# [OPTIONAL] The model used specifically for analyzing audio content.
# Default: gemini-3.1-flash-lite
# GEMINI_AUDIO_ANALYSIS_MODEL_ID=gemini-3.1-flash-lite

# [OPTIONAL] The model used for the Gemini Writers Workshop page.
# Default: Same as MODEL_ID
# GEMINI_WRITERS_WORKSHOP_MODEL_ID=

# ==============================================================================
# 🎥 Veo (Video Generation)
# ==============================================================================

# [OPTIONAL] The standard Veo model version.
# Default: veo-3.1-fast-generate-001
# VEO_MODEL_ID=veo-3.1-fast-generate-001
# Default: us-central1
# VEO_LOCATION=us-central1
# Default: global
# PREVIEW_LOCATION=global

# [OPTIONAL] Allows using a different project for Veo quota if needed.
# Default: Same as PROJECT_ID
# VEO_PROJECT_ID=

# [OPTIONAL] The experimental/newer Veo model version.
# Default: veo-3.1-generate-001
# VEO_EXP_MODEL_ID=veo-3.1-generate-001

# [OPTIONAL] The faster, lower-latency experimental Veo model.
# Default: veo-3.1-fast-generate-001
# VEO_EXP_FAST_MODEL_ID=veo-3.1-fast-generate-001

# [OPTIONAL] Project ID for experimental Veo models.
# Default: Same as PROJECT_ID
# VEO_EXP_PROJECT_ID=

# ==============================================================================
# 🎨 Imagen (Image Generation & Editing)
# ==============================================================================

# [OPTIONAL] Model used for "Product Recontextualization" features.
# Default: imagen-product-recontext-preview-06-30
# MODEL_IMAGEN_PRODUCT_RECONTEXT=imagen-product-recontext-preview-06-30

# [OPTIONAL] Subfolder in the GCS bucket where generated images are saved.
# Default: generated_images
# IMAGEN_GENERATED_SUBFOLDER=generated_images

# [OPTIONAL] Subfolder for images resulting from editing operations.
# Default: edited_images
# IMAGEN_EDITED_SUBFOLDER=edited_images

# ==============================================================================
# 🛍️ Virtual Try-On (VTO)
# ==============================================================================

# [OPTIONAL] Region for the VTO API.
# Default: us-central1
# VTO_LOCATION=us-central1

# [OPTIONAL] The specific VTO model version.
# Default: virtual-try-on-001
# VTO_MODEL_ID=virtual-try-on-preview-08-04

# [OPTIONAL] Firestore collection for VTO model data.
# Default: genmedia-vto-model
# GENMEDIA_VTO_MODEL_COLLECTION_NAME=genmedia-vto-model

# [OPTIONAL] Firestore collection for VTO product catalog data.
# Default: genmedia-vto-catalog
# GENMEDIA_VTO_CATALOG_COLLECTION_NAME=genmedia-vto-catalog

# ==============================================================================
# 🎵 Lyria (Music Generation)
# ==============================================================================

# [OPTIONAL] Region for Lyria API calls.
# Default: us-central1
# LYRIA_LOCATION=us-central1

# [OPTIONAL] The version of the Lyria model to use.
# Default: lyria-002
# LYRIA_MODEL_VERSION=lyria-002

# [OPTIONAL] Project ID for Lyria quota.
# Default: Same as PROJECT_ID
# LYRIA_PROJECT_ID=

# ==============================================================================
# 💾 Storage & Database (Firebase/GCS)
# ==============================================================================

# [OPTIONAL] The Firestore database ID.
# Default: (default)
# GENMEDIA_FIREBASE_DB=(default)

# [OPTIONAL] The main Firestore collection for storing generation metadata.
# Default: genmedia
# GENMEDIA_COLLECTION_NAME=genmedia

# [OPTIONAL] Firestore collection for user session data.
# Default: sessions
# SESSIONS_COLLECTION_NAME=sessions

# [OPTIONAL] The primary GCS bucket for storing generated media.
# Default: {PROJECT_ID}-assets
# GENMEDIA_BUCKET=

# [OPTIONAL] Specific bucket/path for video files.
# Default: {PROJECT_ID}-assets/videos
# VIDEO_BUCKET=

# [OPTIONAL] Specific bucket/path for image files.
# Default: {PROJECT_ID}-assets/images
# IMAGE_BUCKET=

# [OPTIONAL] Used by Lyria and potentially other legacy components.
# Default: {PROJECT_ID}-assets
# MEDIA_BUCKET=

# [OPTIONAL] Bucket for static assets used in the "About" page.
# GCS_ASSETS_BUCKET=

# ==============================================================================
# ⚙️ Application Logic
# ==============================================================================

# [OPTIONAL] Controls how many items appear per page in the media library.
# Default: 15
# LIBRARY_MEDIA_PER_PAGE=15

# [OPTIONAL] If true, media URLs are proxied to avoid CORS/hotlinking issues.
# Default: true
# USE_MEDIA_PROXY=true

# [OPTIONAL] Model used specifically in the Character Consistency workflow.
# Default: veo-3.1-fast-generate-001
# CHARACTER_CONSISTENCY_VEO_MODEL=veo-3.1-fast-generate-001

# [OPTIONAL] Gemini model used in the Character Consistency workflow.
# Default: Same as MODEL_ID
# CHARACTER_CONSISTENCY_GEMINI_MODEL=