.env.example

# Copy to .env and adjust as needed.

# -------- Docker Runtime --------
DOCKER_NETWORK=scene-agent-tools
TOOL_PULL_IMAGES=false
TOOL_RECREATE_CONTAINERS=true
ENABLE_TRELLIS2=true
ASSET_RETRIEVAL_BACKEND=objaverse
ENABLE_PCG=true
WAIT_FOR_HEALTH_TIMEOUT_SECONDS=300

# -------- Image References (Docker Hub) --------
TRELLIS2_IMAGE=fishwowater/trellis2-api:latest
OBJAVERSE_IMAGE=fishwowater/assetretrieval3d:latest
PCG_IMAGE=fishwowater/pcgintegrator3d:latest

# -------- Container Names --------
TRELLIS2_CONTAINER=trellis2-server
OBJAVERSE_CONTAINER=asset-retrieval-server
SCENESMITH_RETRIEVAL_CONTAINER=scenesmith-retrieval-server
PCG_CONTAINER=pcg-integrator-server
POSTGRES_CONTAINER=asset-retrieval-postgres
SAMSERVER_CONTAINER=samserver-http

# -------- Public Bindings (Host) --------
TRELLIS2_HOST=0.0.0.0
TRELLIS2_PORT=8001
# AssetRetrieval3D host binding (used when ASSET_RETRIEVAL_BACKEND=objaverse)
OBJAVERSE_HOST=0.0.0.0
OBJAVERSE_PORT=8002
# SceneSmith compatibility API host binding (used when ASSET_RETRIEVAL_BACKEND=scenesmith)
SCENESMITH_COMPAT_HOST=0.0.0.0
SCENESMITH_COMPAT_PORT=8005
PCG_HOST=0.0.0.0
PCG_PORT=8003

# -------- Internal Ports (Container) --------
TRELLIS2_CONTAINER_PORT=8001
OBJAVERSE_CONTAINER_PORT=8002
SCENESMITH_COMPAT_CONTAINER_PORT=8005
PCG_CONTAINER_PORT=8003

# -------- SAMServer Runtime (compose-managed, disabled by default) --------
ENABLE_SAMSERVER=false
SAMSERVER_HOST=0.0.0.0
SAMSERVER_PORT=8004
SAMSERVER_CONTAINER_PORT=8003
SAMSERVER_INTERNAL_SAM_PORT=8001
SAMSERVER_INTERNAL_SAM3D_PORT=8002
SAMSERVER_ENABLE_GPU=true
SAMSERVER_VISIBLE_DEVICES=all
SAMSERVER_MODEL_DIR=./cache/samserver/models
SAMSERVER_JOB_DIR=./cache/samserver/jobs

# -------- TRELLIS2 Runtime --------
# Set true on GPU hosts with nvidia-container-toolkit installed.
# start_tool_servers.sh will include docker-compose.tools.gpu.yml when true.
TRELLIS2_ENABLE_GPU=true
# Compose schema in this project requires `gpus: all`.
# Select specific GPU(s) via NVIDIA_VISIBLE_DEVICES syntax:
# - only second GPU: `1`
# - multiple GPUs: `0,1`
# - all GPUs: `all`
TRELLIS2_GPU=all
TRELLIS2_VISIBLE_DEVICES=all
HUGGINGFACE_TOKEN=
HUGGINGFACE_CACHE_DIR=./cache/huggingface/hub
# Optional overrides. Keep empty to auto-enable only when host HTTP_PROXY/HTTPS_PROXY is set.
TRELLIS2_HTTP_PROXY=
TRELLIS2_HTTPS_PROXY=
TRELLIS2_NO_PROXY=

# -------- PostgreSQL Runtime (compose-managed) --------
POSTGRES_IMAGE=pgvector/pgvector:pg17
POSTGRES_DATA_DIR=./cache/postgres
POSTGRES_INIT_DIR=./postgres/init

# -------- AssetRetrieval3D Runtime --------
DASHSCOPE_API_KEY=
DB_HOST=postgres
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=postgres
DB_NAME_QWEN=qwen_embeddings
# Optional overrides. Keep empty to auto-enable only when host HTTP_PROXY/HTTPS_PROXY is set.
OBJAVERSE_HTTP_PROXY=
OBJAVERSE_HTTPS_PROXY=
OBJAVERSE_NO_PROXY=
OBJAVERSE_CACHE_DIR=./cache/asset-retrieval
QWEN_DB_AUTO_BOOTSTRAP=true
QWEN_DB_OSS_URL=https://huggingface.co/datasets/zipingli/objaverse_retrieval_embeddings/resolve/main/qwen_embeddings_20260212_170200.dump.gz
QWEN_DB_DUMP_FORMAT=auto
QWEN_DB_DUMP_LOCAL_PATH=/cache/asset-retrieval/qwen_embeddings.dump.gz
QWEN_DB_REUSE_LOCAL_DUMP=true
QWEN_DB_DOWNLOAD_TIMEOUT_SECONDS=1800
MAX_ASSETS=0
LOG_LEVEL=INFO
BASE_URL_TEMPLATE=https://huggingface.co/datasets/allenai/objaverse/resolve/main/glbs/{objaverse_dir}/{objaverse_id}.glb?download=true

# -------- PCGIntegrator3D Runtime --------
PCG_ENVIRONMENT=production
PCG_OUTPUT_BASE_DIR=/app/outputs

# -------- Local Shell Runtime (manage_tool_servers_local.sh only) --------
# These toggles are separate from the Docker ENABLE_* flags above.
# Use them only with manage_tool_servers_local.sh.
ENABLE_TOOL_SERVER_TRELLIS2=false
ENABLE_TOOL_SERVER_PCG=false
ENABLE_TOOL_SERVER_SAM=false

TOOL_SERVER_TRELLIS2_CONDA_ENV=trellis2
TOOL_SERVER_ASSET_RETRIEVAL_CONDA_ENV=asset-retrieval
TOOL_SERVER_PCG_CONDA_ENV=pcg
TOOL_SERVER_SAM_CONDA_ENV=sam
TOOL_SERVER_SAM3D_CONDA_ENV=sam3d-objects
# Leave empty to reuse TOOL_SERVER_SAM3D_CONDA_ENV.
TOOL_SERVER_SAM_PUBLIC_CONDA_ENV=

# Local shell asset retrieval backend:
# - disabled: do not start asset retrieval in local shell mode
# - objaverse: existing Objaverse/Qwen backend
# - scenesmith: self-contained SceneSmithRetrieval submodule
TOOL_SERVER_ASSET_RETRIEVAL_BACKEND=disabled

# SceneSmithRetrieval toggles.
ENABLE_AMBIENTCG=false

# SceneSmith real dataset paths. Put real data under SceneSmithRetrieval/data
# or point these at absolute dataset locations.
HSSD_DATA_PATH="${PWD}/SceneSmithRetrieval/data/hssd-models"
HSSD_PREPROCESSED_PATH="${PWD}/SceneSmithRetrieval/data/preprocessed"
HSSD_ARTIFACT_ROOT="${PWD}/cache/scenesmith/hssd"
AMBIENTCG_DATA_PATH="${PWD}/SceneSmithRetrieval/data/materials"
AMBIENTCG_EMBEDDINGS_PATH="${PWD}/SceneSmithRetrieval/data/materials/embeddings"
AMBIENTCG_ARTIFACT_ROOT="${PWD}/cache/scenesmith/ambientcg"

TOOL_SERVER_RUN_DIR=./.run
TOOL_SERVER_PID_FILE=./.run/tool_servers_local.pid
TOOL_SERVER_LOG_DIR=./.run/logs

# Objaverse local shell mode does not manage PostgreSQL.
# Point these to an already running database.
TOOL_SERVER_OBJAVERSE_DB_HOST=127.0.0.1
TOOL_SERVER_OBJAVERSE_DB_PORT=5432

SAM_HTTP_HOST=0.0.0.0
SAM_HTTP_PORT=8004
SAM_INTERNAL_PORT=8001
SAM3D_INTERNAL_PORT=8002