chore: import upstream snapshot with attribution

2026-07-13 11:59:14 +08:00
commit bf122cd71b
5779 changed files with 1480999 additions and 0 deletions
@@ -0,0 +1,24 @@
+"""
+Ensures `.env.local` exists so developers have a place to put overrides
+(API keys, local model choices, etc.) without touching the committed `.env`.
+
+Usage:
+    uv run scripts/setup_env.py
+"""
+
+from pathlib import Path
+
+ROOT = Path(__file__).parent.parent
+ENV_LOCAL_FILE = ROOT / ".env.local"
+
+TEMPLATE = """\
+###############################################################################
+# Local overrides for `engine/.env`
+# Put API keys and machine-specific settings here. Any variable defined here
+# takes precedence over the committed `.env`
+###############################################################################
+"""
+
+if not ENV_LOCAL_FILE.exists():
+    ENV_LOCAL_FILE.write_text(TEMPLATE)
+    print("setup-env: created empty .env.local for local overrides")