platform stack : web studio ui, dual track observability, python sdk, and s1-s7 scenarios

.dockerignore

@@ -0,0 +1,3 @@
+target/
+.git/
+.env

.env.example

@@ -1,21 +1,37 @@
-# Example environment for mofa-studio (and any app using the Agnes / Ark backends).
+# ==============================================================================
+# MoFA Engine — Environment Variables & Cloud Provider Keys
+# ==============================================================================
+# Copy this file to .env and fill in your keys:
+#   cp .env.example .env
 #
-# Copy this to `.env.local` (gitignored), fill in your key, then:
-#   source .env.local && cargo run -p mofa-studio
-#
-# `.env.local` is NOT auto-loaded by the app — you `source` it so the values land
-# in the process environment, where the engine resolves `api_key = "env:VAR"`.
+# Or run the interactive key configurator:
+#   bash quickstart.sh keys
+# ==============================================================================
+
+# 1. Google Gemini Cloud Provider (Chat + Reasoning + Native Audio TTS)
+# Free Tier available at: https://aistudio.google.com/app/apikey
+GEMINI_API_KEY=""
+
+# 2. OpenAI Cloud Provider (GPT-4o + Whisper ASR + DALL-E-3)
+# Key available at: https://platform.openai.com/api-keys
+OPENAI_API_KEY=""
+
+# 3. DeepSeek Reasoning Provider (DeepSeek-R1 Deep Thinking)
+# Key available at: https://platform.deepseek.com/api_keys
+DEEPSEEK_API_KEY=""
 
-# --- Agnes AI (free omni-modal gateway) — chat + image + video ---
-# Get a free key at https://agnes-ai.com. This one key enables all three.
-export AGNES_API_KEY=""
+# 4. Fireworks AI Provider (Serverless Open Models)
+# Key available at: https://fireworks.ai/api-keys
+FIREWORKS_API_KEY=""
 
-# Endpoint + model ids (defaults shown; override only if the docs change):
-export AGNES_BASE_URL="https://apihub.agnes-ai.com/v1"
-export AGNES_CHAT_MODEL="agnes-2.5-flash"
-export AGNES_IMAGE_MODEL="agnes-image-2.1-flash"
-export AGNES_VIDEO_MODEL="agnes-video-v2.0"      # or "agnes-video-2.5"
+# 5. MoFA Gateway Security (Optional Bearer Token)
+# If set, all /v1 requests must pass Authorization: Bearer <token>
+MOFA_API_TOKEN=""
 
-# --- Seedance via Volcengine Ark (alternative video backend) ---
-# Only needed if you use the Ark dialect instead of Agnes for video.
-# export ARK_API_KEY=""
+# --- Agnes AI (Omni-modal gateway: chat + image + video) ---
+# Free key at https://agnes-ai.com
+AGNES_API_KEY=""
+AGNES_BASE_URL="https://apihub.agnes-ai.com/v1"
+AGNES_CHAT_MODEL="agnes-2.5-flash"
+AGNES_IMAGE_MODEL="agnes-image-2.1-flash"
+AGNES_VIDEO_MODEL="agnes-video-v2.0"

.gitignore

@@ -7,3 +7,25 @@ __pycache__/
 node_modules/
 e2e/test-results/
 e2e/playwright-report/
+.kokoro-models/
+.kokoro-venv/
+.venv/
+.DS_Store
+*.DS_Store
+dist/
+.ua/
+mofa_hybrid.toml
+test_obs_config.toml
+*.mp3
+*.png
+*.mp4
+*.pdf
+output/
+!examples/samples/*
+!examples/samples/*.mp3
+!examples/samples/*.png
+!examples/samples/*.wav
+mofa_asr_upload_*.txt
+config.toml
+
+