prep for hf deploy

.gitignore

@@ -1,6 +1,5 @@
-# Local notes / source briefs
-jd.txt
-prompt.txt
+# Local notes
+local/
 
 # Secrets
 .env

Procfile

@@ -1 +0,0 @@
-web: uvicorn api.main:app --host 0.0.0.0 --port $PORT

README.md

@@ -32,14 +32,14 @@ with a FitFuel example), click **Generate**, and watch the agent retrieve past
 winners, generate three variants, and score each on four dimensions in real time.
 
 - **Frontend:** Next.js (App Router) deployed on **Vercel**, in [`web/`](web/).
-- **Backend:** the FastAPI app deployed on **Railway** (see [`Procfile`](Procfile)),
+- **Backend:** the FastAPI app deployed on **Hugging Face Spaces** (Docker, see [`Dockerfile`](Dockerfile)),
   with CORS, a per-IP rate limit on `/run`, a `/stats` endpoint, and a startup
   seed so a fresh deployment shows non-zero stats and working retrieval on the
   very first visit.
 
 > Deployment env vars: the backend needs `GROQ_API_KEY` (and optionally
 > `CORS_ORIGINS` = your Vercel URL); the frontend needs `NEXT_PUBLIC_API_URL` =
-> your Railway backend URL. See the per-app `.env.example` files.
+> your Hugging Face Space URL. See the per-app `.env.example` files.
 
 ---
 

api/main.py

@@ -1,7 +1,7 @@
 """FastAPI app for the hosted public demo.
 
 Endpoints:
-- GET  /health  -> liveness probe for Railway
+- GET  /health  -> liveness probe
 - GET  /stats   -> live counts (runs, golden, flagged) for the frontend strip
 - POST /run     -> full agent loop (rate limited), returns outputs + scores
 

web/.env.example

@@ -1,4 +1,4 @@
 # URL of the FastAPI backend the frontend calls (/run and /stats).
 # Locally, point this at the running uvicorn server (default port 8000).
-# In production, set it to your Railway backend URL in the Vercel dashboard.
+# In production, set it to your Hugging Face Space URL in the Vercel dashboard.
 NEXT_PUBLIC_API_URL=http://localhost:3000

web/app/page.tsx

@@ -8,12 +8,12 @@ import { StatsStrip } from "@/components/StatsStrip";
 import { ApiError, getStats, runAgent } from "@/lib/api";
 import type { Brief, RunResponse, Stats } from "@/lib/types";
 
-const EXAMPLE_BRIEF: Brief = {
-  brand: "FitFuel",
-  product: "High-protein meal replacement shake",
-  audience: "Busy professionals aged 25-40",
-  tone: "Energetic and no-nonsense",
-  goal: "Drive trial purchases",
+const EMPTY_BRIEF: Brief = {
+  brand: "",
+  product: "",
+  audience: "",
+  tone: "",
+  goal: "",
 };
 
 // Ordered variant rendering regardless of backend ordering.
@@ -30,7 +30,7 @@ const LOADING_PHASES = [
 ];
 
 export default function Page() {
-  const [brief, setBrief] = useState<Brief>(EXAMPLE_BRIEF);
+  const [brief, setBrief] = useState<Brief>(EMPTY_BRIEF);
   const [loading, setLoading] = useState(false);
   const [phase, setPhase] = useState(0);
   const [result, setResult] = useState<RunResponse | null>(null);
@@ -69,7 +69,12 @@ export default function Page() {
   const onChange = (key: keyof Brief, value: string) =>
     setBrief((b) => ({ ...b, [key]: value }));
 
+  const isComplete = (Object.keys(brief) as (keyof Brief)[]).every(
+    (k) => brief[k].trim() !== "",
+  );
+
   const onSubmit = async () => {
+    if (!isComplete) return;
     setLoading(true);
     setError(null);
     try {
@@ -115,6 +120,7 @@ export default function Page() {
         onSubmit={onSubmit}
         loading={loading}
         statusText={LOADING_PHASES[phase]}
+        canSubmit={isComplete}
       />
 
       {/* Error */}
@@ -153,8 +159,8 @@ export default function Page() {
       </div>
 
       <footer className="mt-10 border-t border-ink-700 pt-5 font-mono text-[11px] text-zinc-600">
-        Backend: FastAPI on Railway · Frontend: Next.js on Vercel · Judge &
-        generator: llama-3.3-70b
+        Backend: FastAPI on Hugging Face Spaces · Frontend: Next.js on Vercel ·
+        Judge &amp; generator: llama-3.3-70b
       </footer>
     </main>
   );

web/components/BriefForm.tsx

@@ -14,12 +14,14 @@ export function BriefForm({
   onSubmit,
   loading,
   statusText,
+  canSubmit,
 }: {
   brief: Brief;
   onChange: (key: keyof Brief, value: string) => void;
   onSubmit: () => void;
   loading: boolean;
   statusText: string;
+  canSubmit: boolean;
 }) {
   return (
     <form
@@ -66,11 +68,11 @@ export function BriefForm({
             loading ? "animate-soft-pulse" : ""
           }`}
         >
-          {loading ? statusText : "Ready"}
+          {loading ? statusText : canSubmit ? "Ready" : "Fill in the brief to generate"}
         </p>
         <button
           type="submit"
-          disabled={loading}
+          disabled={loading || !canSubmit}
           className="border border-zinc-300 bg-zinc-100 px-4 py-2 text-sm font-medium text-ink-950 transition-colors hover:bg-white disabled:cursor-not-allowed disabled:border-ink-600 disabled:bg-ink-700 disabled:text-zinc-400"
         >
           {loading ? "Running..." : "Generate Copy"}