Deploy Epic Errands V2 Space

README.md

@@ -8,6 +8,16 @@ sdk_version: 6.18.0
 app_file: app.py
 pinned: false
 license: mit
+tags:
+  - track:wood
+  - sponsor:openbmb
+  - sponsor:openai
+  - sponsor:nvidia
+  - sponsor:modal
+  - achievement:offbrand
+  - achievement:llama
+  - achievement:sharing
+  - achievement:fieldnotes
 ---
 
 # Epic Errands V2 Mobile Review

app.py

@@ -15,7 +15,12 @@ from gradio.workflow import WRITE_TOKEN
 from gradio import Server
 
 from diy_lab.epic_errands_diy_workflow.workflow_adapter import build_workflow_canvas_app
-from epic_errands_v2.generation import build_app_bootstrap, build_diy_state, build_generated_goal
+from epic_errands_v2.generation import (
+    build_app_bootstrap,
+    build_diy_state,
+    build_generated_goal,
+    build_generated_goal_with_live_fallback,
+)
 
 
 ROOT = Path(__file__).resolve().parent
@@ -81,7 +86,7 @@ def build_server() -> Server:
             "frontend": "fully-custom-ui",
             "version": "v2",
             "proof_claim": "local_implementation_only",
-            "live_generation": "disabled",
+            "live_generation": _live_generation_label(),
             "quality_text_model": "nvidia/NVIDIA-Nemotron-3-Nano-4B-GGUF",
             "quality_image_model": "black-forest-labs/FLUX.2-klein-9B",
             "quality_audio_model": "openbmb/VoxCPM2",
@@ -95,7 +100,7 @@ def build_server() -> Server:
     @app.post("/api/generate-goal")
     async def generate_goal(payload: dict[str, Any] = Body(default_factory=dict)) -> JSONResponse:
         return JSONResponse(
-            build_generated_goal(
+            build_generated_goal_with_live_fallback(
                 str(payload.get("ordinary_goal") or ""),
                 str(
                     payload.get("ui_theme_id")
@@ -251,7 +256,7 @@ def _hosted_bootstrap(payload_json: str | None = None) -> str:
 
 def _hosted_generate_goal(payload_json: str | None = None) -> str:
     payload = _decode_request(payload_json)
-    generated = build_generated_goal(
+    generated = build_generated_goal_with_live_fallback(
         str(payload.get("ordinary_goal") or ""),
         str(
             payload.get("ui_theme_id")
@@ -264,14 +269,16 @@ def _hosted_generate_goal(payload_json: str | None = None) -> str:
         ],
         audio_used_parent_reference=bool(payload.get("audio_used_parent_reference")),
     )
+    fallback_used = bool(generated.get("provenance", {}).get("fallback_used", True))
     generated["provenance"] = {
         **generated.get("provenance", {}),
         "app_host": "hf_space_gradio_blocks",
-        "model_runtime": "none",
-        "model_backend": "static_review_asset",
+        "model_runtime": generated.get("provenance", {}).get("model_runtime") or ("none" if fallback_used else "modal"),
+        "model_backend": generated.get("provenance", {}).get("model_backend") or ("static_review_asset" if fallback_used else "modal_http"),
         "backend_transport": "gradio_blocks_named_api",
         "api_name": "epic_generate_goal",
-        "fallback_reason": "deterministic hosted dry-run; Modal/live model not wired to hosted app",
+        "fallback_reason": generated.get("provenance", {}).get("fallback_reason")
+        or ("deterministic hosted dry-run; Modal/live generation disabled or unavailable" if fallback_used else ""),
     }
     return json.dumps(generated, separators=(",", ":"))
 
@@ -301,6 +308,14 @@ def _data_uri(path: Path) -> str:
     return f"data:{mime_type};base64,{encoded}"
 
 
+def _live_generation_label() -> str:
+    if os.environ.get("EPIC_ENABLE_LIVE_GENERATION", "").strip().lower() in {"1", "true", "yes"}:
+        return "enabled"
+    if os.environ.get("APP_DRY_RUN", "true").strip().lower() in {"0", "false", "no"}:
+        return "enabled"
+    return "disabled"
+
+
 server = build_server()
 app = build_hosted_demo()
 

diy_lab/epic_errands_diy_workflow/modal_client.py

@@ -51,12 +51,20 @@ class ModalClientConfig:
     @classmethod
     def from_env(cls) -> "ModalClientConfig":
         dry_value = os.environ.get("APP_DRY_RUN", "true").strip().lower()
+        live_value = os.environ.get("EPIC_ENABLE_LIVE_GENERATION", "").strip().lower()
+        dry_run = dry_value not in {"0", "false", "no"}
+        if live_value in {"1", "true", "yes"}:
+            dry_run = False
         return cls(
-            dry_run=dry_value not in {"0", "false", "no"},
-            base_url=os.environ.get("APP_MODAL_BASE_URL", ""),
-            text_url=os.environ.get("APP_MODAL_TEXT_URL", ""),
-            image_url=os.environ.get("APP_MODAL_IMAGE_URL", ""),
-            audio_url=os.environ.get("APP_MODAL_AUDIO_URL", ""),
+            dry_run=dry_run,
+            base_url=os.environ.get("APP_MODAL_BASE_URL", "") or os.environ.get("EPIC_MODAL_BASE_URL", ""),
+            text_url=os.environ.get("APP_MODAL_TEXT_URL", "") or os.environ.get("EPIC_MODAL_TEXT_URL", ""),
+            image_url=os.environ.get("APP_MODAL_IMAGE_URL", "") or os.environ.get("EPIC_MODAL_IMAGE_URL", ""),
+            audio_url=(
+                os.environ.get("APP_MODAL_AUDIO_URL", "")
+                or os.environ.get("EPIC_MODAL_AUDIO_URL", "")
+                or os.environ.get("EPIC_MODAL_VOXCPM2_URL", "")
+            ),
             auth_token=os.environ.get("APP_MODAL_AUTH_TOKEN", ""),
             timeout_seconds=float(os.environ.get("APP_MODAL_TIMEOUT_SECONDS", "45") or 45),
             model_id=os.environ.get("APP_MODAL_MODEL_ID", ""),
@@ -217,7 +225,7 @@ class ModalClient:
 def _metadata_from_modal(result: dict[str, Any]) -> RuntimeMetadata:
     return RuntimeMetadata(
         lifecycle_stage=str(result.get("lifecycle_stage") or "testing"),
-        app_host="local",
+        app_host="hf_space" if os.environ.get("SPACE_ID") else "local",
         model_runtime=str(result.get("model_runtime") or "modal"),
         model_backend=str(result.get("model_backend") or "modal_http"),
         inference_engine=str(result.get("inference_engine") or "unknown"),

epic_errands_v2/generation.py

@@ -1,7 +1,10 @@
 from __future__ import annotations
 
+from dataclasses import asdict
 from datetime import datetime, timezone
 import hashlib
+import os
+import time
 from typing import Any
 
 from .contracts import EditableTextLayer, GeneratedGoal, GeneratedMedia
@@ -91,6 +94,141 @@ def build_generated_goal(
     }
 
 
+def build_generated_goal_with_live_fallback(
+    ordinary_goal: str,
+    ui_theme_id: str = "questbook",
+    selected_generation_reference_ids: list[str] | None = None,
+    *,
+    audio_used_parent_reference: bool = False,
+) -> dict[str, Any]:
+    if not _live_generation_enabled():
+        return build_generated_goal(
+            ordinary_goal,
+            ui_theme_id,
+            selected_generation_reference_ids=selected_generation_reference_ids,
+            audio_used_parent_reference=audio_used_parent_reference,
+        )
+
+    try:
+        return _build_modal_generated_goal(
+            ordinary_goal,
+            ui_theme_id,
+            selected_generation_reference_ids=selected_generation_reference_ids,
+            audio_used_parent_reference=audio_used_parent_reference,
+        )
+    except Exception as exc:  # noqa: BLE001 - user-facing fallback keeps hosted app usable.
+        fallback = build_generated_goal(
+            ordinary_goal,
+            ui_theme_id,
+            selected_generation_reference_ids=selected_generation_reference_ids,
+            audio_used_parent_reference=audio_used_parent_reference,
+        )
+        fallback["provenance"] = {
+            **fallback.get("provenance", {}),
+            "backend_transport": "modal_http",
+            "fallback_reason": f"{exc.__class__.__name__}: {exc}",
+            "fallback_used": True,
+        }
+        return fallback
+
+
+def _build_modal_generated_goal(
+    ordinary_goal: str,
+    ui_theme_id: str,
+    selected_generation_reference_ids: list[str] | None = None,
+    *,
+    audio_used_parent_reference: bool = False,
+) -> dict[str, Any]:
+    from diy_lab.epic_errands_diy_workflow.contracts import AudioRequest, ImageRequest, PlainGoalInput
+    from diy_lab.epic_errands_diy_workflow.modal_client import ModalClient
+
+    theme = _theme(ui_theme_id)
+    goal_text = ordinary_goal.strip() or "Finish a helpful errand"
+    reference_signature = ",".join(selected_generation_reference_ids or [])
+    goal_id = f"goal-{hashlib.sha1(f'{goal_text}:{reference_signature}'.encode('utf-8')).hexdigest()[:10]}"
+    started = time.monotonic()
+    client = ModalClient()
+    if client.config.dry_run:
+        raise RuntimeError("Live generation is enabled, but Modal client is still in dry-run mode.")
+
+    goal = PlainGoalInput(goal_id=goal_id, ordinary_goal=goal_text, theme=theme)
+    text = client.generate_text(goal)
+    card_text = {
+        "title": text.title,
+        "narration": text.narration,
+        "reward_label": text.reward_label,
+    }
+    image = client.generate_image(
+        ImageRequest(
+            goal_id=goal_id,
+            ordinary_goal=goal_text,
+            theme=theme,
+            card_text=card_text,
+            prompt="",
+            width=768,
+            height=768,
+            seed=26000 + len(goal_text),
+        )
+    )
+    audio = client.generate_audio(
+        AudioRequest(
+            goal_id=goal_id,
+            ordinary_goal=goal_text,
+            theme=theme,
+            card_text=card_text,
+            spoken_text=f"{text.title}. {text.narration}",
+            audio_prompt="",
+        )
+    )
+
+    if not image.artifact_uri.startswith("data:image/"):
+        raise RuntimeError("Modal image response did not include image data.")
+    if not audio.artifact_uri.startswith("data:audio/"):
+        raise RuntimeError("Modal audio response did not include audio data.")
+
+    now = datetime.now(timezone.utc).isoformat()
+    runtime_steps = {
+        "text": asdict(text.runtime_metadata),
+        "image": asdict(image.runtime_metadata),
+        "audio": asdict(audio.runtime_metadata),
+    }
+    fallback_used = any(bool(step.get("fallback_used")) for step in runtime_steps.values())
+    generated = GeneratedGoal(
+        id=goal_id,
+        ordinary_goal=goal_text,
+        theme_id_at_creation=theme,
+        selected_generation_reference_ids=selected_generation_reference_ids or [],
+        generated_title=text.title,
+        generated_narration=text.narration,
+        generated_reward_label=text.reward_label,
+        overlay_text=EditableTextLayer(text=goal_text, theme_style_id=theme),
+        media=GeneratedMedia(
+            image_asset_ref=image.artifact_uri,
+            audio_asset_ref=audio.artifact_uri,
+            audio_used_parent_reference=audio_used_parent_reference,
+        ),
+        provenance={
+            **quality_provenance(trace_id=f"hosted-v2-modal-{goal_id}", fallback_used=fallback_used),
+            "app_host": "hf_space" if os.environ.get("SPACE_ID") else "local",
+            "model_runtime": "modal",
+            "model_backend": "modal_http",
+            "backend_transport": "modal_http",
+            "api_name": "epic_generate_goal",
+            "latency_ms": round((time.monotonic() - started) * 1000),
+            "modal_runtime_steps": runtime_steps,
+        },
+        created_at=now,
+    )
+    return {
+        **generated.__dict__,
+        "overlay_text": generated.overlay_text.__dict__,
+        "media": generated.media.__dict__,
+        "kid_completion_state": "not_started",
+        "parent_reward_state": "not_reviewed",
+        "updated_at": now,
+    }
+
+
 def build_diy_state(
     theme_id: str,
     ordinary_goal: str,
@@ -139,6 +277,13 @@ def build_diy_state(
     }
 
 
+def _live_generation_enabled() -> bool:
+    return (
+        os.environ.get("EPIC_ENABLE_LIVE_GENERATION", "").strip().lower() in {"1", "true", "yes"}
+        or os.environ.get("APP_DRY_RUN", "true").strip().lower() in {"0", "false", "no"}
+    )
+
+
 def _theme(value: str) -> str:
     return {"magical": "questbook"}.get(str(value or "questbook").lower(), str(value or "questbook").lower()) if str(value or "").lower() in THEMES or str(value or "").lower() == "magical" else "questbook"
 

frontend/scripts/app.js

@@ -176,6 +176,7 @@
   }
 
   function asset(path) {
+    if (/^(data:|https?:|blob:)/.test(String(path || ""))) return path;
     if (ASSET_MANIFEST[path]) return ASSET_MANIFEST[path];
     return `${ASSET_BASE}${path}`;
   }