databricks-forge/.env.local.example at main · databricks-solutions/databricks-forge · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
# Databricks Forge -- Local Development Configuration
#
# RECOMMENDED: Run `.deploy_local.sh` to auto-generate this file.
# It provisions Lakebase, selects a warehouse, and writes all values below.
#
# AUTHENTICATION: No PAT or token is needed in this file. The app uses the
# Databricks CLI's OAuth session (`databricks auth login`) to get short-lived
# tokens at runtime. If you prefer a PAT, set DATABRICKS_TOKEN below.

# ---------------------------------------------------------------------------
# Required -- set by .deploy_local.sh
# ---------------------------------------------------------------------------

# Workspace URL
DATABRICKS_HOST=https://your-workspace.cloud.databricks.com

# SQL Warehouse ID
DATABRICKS_WAREHOUSE_ID=your_sql_warehouse_id

# Lakebase connection string. `.deploy_local.sh` writes the generated value.
# Leave blank only when preparing this file manually before provisioning.
DATABASE_URL=

# User identity (replaces OBO proxy headers for local dev)
FORGE_LOCAL_USER_EMAIL=your.email@company.com

# Port (matches Databricks Apps convention)
DATABRICKS_APP_PORT=3000

# ---------------------------------------------------------------------------
# Optional -- authentication override
# ---------------------------------------------------------------------------

# Uncomment to use a PAT instead of CLI OAuth session:
# DATABRICKS_TOKEN=dapi_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Databricks CLI profile for multi-workspace setups.
# When set, `databricks auth token --profile <name>` is used instead of --host.
# Set automatically by `.deploy_local.sh --profile <name>`.
# DATABRICKS_CLI_PROFILE=staging

# ---------------------------------------------------------------------------
# Optional -- model endpoints
# ---------------------------------------------------------------------------

# Primary model (defaults to databricks-claude-opus-4-7)
# DATABRICKS_SERVING_ENDPOINT=databricks-claude-opus-4-7

# Fast model for classification / metadata (defaults to primary)
# DATABRICKS_SERVING_ENDPOINT_FAST=databricks-claude-sonnet-4-6

# SQL quality review model (defaults to primary)
# DATABRICKS_REVIEW_ENDPOINT=databricks-gpt-5-4

# Embedding model for semantic search / Ask Forge RAG
# DATABRICKS_EMBEDDING_ENDPOINT=databricks-qwen3-embedding-0-6b

# Additional model pool endpoints for parallel LLM routing
# DATABRICKS_SERVING_ENDPOINT_REASONING_2=databricks-claude-opus-4-6
# DATABRICKS_SERVING_ENDPOINT_GENERATION=databricks-claude-sonnet-4-6
# DATABRICKS_SERVING_ENDPOINT_SQL=databricks-gpt-5-3-codex
# DATABRICKS_SERVING_ENDPOINT_LIGHTWEIGHT=databricks-gemini-3-1-flash-lite

# Restrict which models the app can use (comma-separated)
# DATABRICKS_ALLOWED_MODELS=databricks-claude-sonnet-4-6,databricks-gpt-5-4

# ---------------------------------------------------------------------------
# Optional -- feature flags
# ---------------------------------------------------------------------------

# Restrict benchmark management to specific emails (comma-separated)
# If unset, all authenticated users can manage benchmarks
# FORGE_BENCHMARK_ADMINS=alice@company.com,bob@company.com

# Enable metric view generation (enabled by default)
# FORGE_METRIC_VIEWS_ENABLED=false

# Enable Fabric / Power BI features (disabled by default)
# FORGE_FABRIC_ENABLED=true

# Enable Demo Mode for Field Engineering / Sales (disabled by default)
# FORGE_DEMO_MODE_ENABLED=true

# ---------------------------------------------------------------------------
# Optional -- cost governance (both are optional and independent)
# ---------------------------------------------------------------------------

# Serverless budget policy ID attached to the Lakebase project (and, when
# set via deploy.sh --budget-policy-id, also to the Databricks App itself).
# Leave unset to inherit the workspace default.
# FORGE_BUDGET_POLICY_ID=policy-id-here

# Custom tags for the Lakebase project, as a JSON array. Applied only to
# the Lakebase project -- the Databricks Apps API does not accept tags on
# the App resource. Updates fully replace existing tags on the project.
#
# Opt-in: deploy.sh only emits this variable when the user passes at
# least one --tag flag. In that case it prepends two defaults unless
# overridden with --tag <same-key>=<value>:
#   project=databricks_forge, owner=<deploy user email>
# When set manually in this file, the entire array is used as-is and
# no defaults are prepended.
# FORGE_CUSTOM_TAGS=[{"key":"team","value":"data-eng"},{"key":"cost-center","value":"1234"}]