feat: upload rendered MP4s to HuggingFace Dataset repo instead of local download

- Renders push to AIgoose/video-renders dataset via huggingface_hub
- Studio UI shows HF link + preview instead of download button
- CommitScheduler auto-batches uploads every 30s
- requirements.txt updated with huggingface_hub
- lib/uploader.js handles the Python bridge upload

lib/uploader.js

@@ -0,0 +1,30 @@
+import { execFile } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Upload a rendered MP4 to HuggingFace Dataset repo.
+ * Returns { hf_url, viewer_url, repo_id, filename } on success.
+ */
+export async function uploadToHuggingFace(localPath, filename) {
+  const token = process.env.HF_TOKEN;
+  if (!token) throw new Error('HF_TOKEN env var not set — cannot upload to HuggingFace');
+
+  return new Promise((resolve, reject) => {
+    const scriptPath = path.join(__dirname, '..', 'uploader.py');
+    const python = process.env.PYTHON_PATH || '/app/venv/bin/python3';
+
+    execFile(python, [scriptPath, localPath, filename, token], { maxBuffer: 1024 * 1024 }, (err, stdout, stderr) => {
+      if (err) { reject(new Error(stderr || err.message)); return; }
+      try {
+        const result = JSON.parse(stdout.trim());
+        if (result.error) { reject(new Error(result.error)); return; }
+        resolve(result);
+      } catch (e) {
+        reject(new Error(`Failed to parse uploader output: ${stdout}`));
+      }
+    });
+  });
+}

requirements.txt

@@ -1,3 +1,4 @@
 requests==2.31.0
 pydub==0.25.1
 numpy==1.26.4
+huggingface_hub==0.23.4

server.js

@@ -10,6 +10,7 @@ import { fileURLToPath } from 'url';
 import { renderVideo } from './lib/renderer.js';
 import { buildComposition } from './lib/composer.js';
 import { getMusicTrack } from './lib/music.js';
+import { uploadToHuggingFace } from './lib/uploader.js';
 import { WORKFLOWS } from './workflows/index.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -40,7 +41,12 @@ function push(jobId, data) {
   if (job) Object.assign(job, data);
 }
 
-app.get('/api/health', (_, res) => res.json({ status: 'ok', time: new Date().toISOString() }));
+app.get('/api/health', (_, res) => res.json({
+  status: 'ok',
+  time: new Date().toISOString(),
+  hf_renders_repo: process.env.HF_RENDERS_REPO || 'AIgoose/video-renders',
+  hf_token_set: !!process.env.HF_TOKEN,
+}));
 
 app.get('/api/workflows', (_, res) => res.json(
   Object.entries(WORKFLOWS).map(([id, w]) => ({ id, ...w.meta }))
@@ -102,18 +108,22 @@ app.post('/api/render', async (req, res) => {
   setImmediate(() => runJob(jobId, projectDir, config));
 });
 
+// Legacy local download (fallback if HF upload fails)
 app.get('/api/download/:jobId', (req, res) => {
   const job = jobs.get(req.params.jobId);
   if (!job?.outputPath || !fs.existsSync(job.outputPath))
-    return res.status(404).json({ error: 'Not ready' });
+    return res.status(404).json({ error: 'Not ready or already uploaded to HF' });
   res.download(job.outputPath);
 });
 
 async function runJob(jobId, projectDir, config) {
   try {
     push(jobId, { status: 'composing', progress: 5 });
-    const musicPath = await getMusicTrack(config.musicTrack, config.workflow, config.duration,
-      (d) => push(jobId, d));
+
+    const musicPath = await getMusicTrack(
+      config.musicTrack, config.workflow, config.duration,
+      (d) => push(jobId, d)
+    );
     push(jobId, { progress: 15 });
 
     const compDir = path.join(__dirname, 'compositions', 'projects', jobId);
@@ -123,17 +133,44 @@ async function runJob(jobId, projectDir, config) {
     if (!workflow) throw new Error(`Unknown workflow: ${config.workflow}`);
 
     await buildComposition(compDir, projectDir, musicPath, config, workflow,
-      (p) => push(jobId, { status: 'composing', progress: 15 + Math.round(p * 0.4) }));
-    push(jobId, { status: 'rendering', progress: 55 });
+      (p) => push(jobId, { status: 'composing', progress: 15 + Math.round(p * 0.35) }));
+
+    push(jobId, { status: 'rendering', progress: 50 });
 
     const outDir = path.join(__dirname, 'renders');
     fs.mkdirSync(outDir, { recursive: true });
     const outputFile = path.join(outDir, `${jobId}.mp4`);
 
     await renderVideo(compDir, outputFile, config,
-      (p) => push(jobId, { status: 'rendering', progress: 55 + Math.round(p * 0.4) }));
-
-    push(jobId, { status: 'done', progress: 100, outputPath: outputFile, outputUrl: `/renders/${jobId}.mp4` });
+      (p) => push(jobId, { status: 'rendering', progress: 50 + Math.round(p * 0.35) }));
+
+    push(jobId, { status: 'uploading', progress: 88 });
+
+    // Build a human-readable filename
+    const slug = (config.clientName || config.projectName || 'video')
+      .toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 40);
+    const ts = new Date().toISOString().slice(0, 10);
+    const hfFilename = `${slug}-${config.workflow}-${ts}-${jobId.slice(0, 8)}.mp4`;
+
+    let hfResult = null;
+    try {
+      hfResult = await uploadToHuggingFace(outputFile, hfFilename);
+      // Clean up local render to save Space disk
+      fs.unlinkSync(outputFile);
+    } catch (uploadErr) {
+      console.warn('[upload warning] HF upload failed, keeping local file:', uploadErr.message);
+    }
+
+    push(jobId, {
+      status: 'done',
+      progress: 100,
+      outputPath: hfResult ? null : outputFile,
+      hf_url: hfResult?.hf_url || null,
+      viewer_url: hfResult?.viewer_url || null,
+      hf_filename: hfResult?.filename || null,
+      repo_id: hfResult?.repo_id || null,
+      outputUrl: hfResult ? hfResult.hf_url : `/renders/${jobId}.mp4`,
+    });
   } catch (err) {
     console.error('[job error]', jobId, err);
     push(jobId, { status: 'error', error: err.message });
@@ -141,4 +178,4 @@ async function runJob(jobId, projectDir, config) {
 }
 
 const PORT = process.env.PORT || 7860;
-server.listen(PORT, () => console.log(`✅ Dee Video Studio on port ${PORT}`));
+server.listen(PORT, () => console.log(`\u2705 Dee Video Studio on port ${PORT}`));

static/index.html

@@ -3,9 +3,9 @@
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Dee Video Studio</title>
+<title>Hyperframes Video Studio</title>
 <style>
-:root{--bg:#0f0f0f;--s:#1a1a1a;--s2:#242424;--b:rgba(255,255,255,0.1);--a:#7C6FE0;--a2:#E06F9A;--t:#e8e6e1;--m:#888;--g:#4ade80;--r:#f87171;--rad:12px}
+:root{--bg:#0f0f0f;--s:#1a1a1a;--s2:#242424;--b:rgba(255,255,255,0.1);--a:#7C6FE0;--a2:#E06F9A;--t:#e8e6e1;--m:#888;--g:#4ade80;--r:#f87171;--hf:#ff9d00;--rad:12px}
 *{box-sizing:border-box;margin:0;padding:0}
 body{background:var(--bg);color:var(--t);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;min-height:100vh}
 header{padding:20px 28px;border-bottom:1px solid var(--b);display:flex;align-items:center;gap:12px}
@@ -27,14 +27,12 @@ header h1{font-size:18px;font-weight:700}header span{font-size:12px;color:var(--
 .drop-zone.drag{border-color:var(--a);background:rgba(124,111,224,.08)}
 .drop-zone input{display:none}
 .drop-zone .dz-icon{font-size:28px;margin-bottom:6px}
-.drop-zone p{font-size:12px;color:var(--m)}
-.drop-zone strong{color:var(--t)}
+.drop-zone p{font-size:12px;color:var(--m)}.drop-zone strong{color:var(--t)}
 .file-list{display:flex;flex-direction:column;gap:5px;margin-top:8px}
 .file-item{display:flex;align-items:center;gap:7px;padding:7px 9px;background:var(--s2);border-radius:7px;font-size:11px}
 .fi-name{flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .fi-size{color:var(--m);flex-shrink:0}
-.fi-rm{background:none;border:none;color:var(--m);cursor:pointer;font-size:13px;padding:0 3px}
-.fi-rm:hover{color:var(--r)}
+.fi-rm{background:none;border:none;color:var(--m);cursor:pointer;font-size:13px;padding:0 3px}.fi-rm:hover{color:var(--r)}
 .field{margin-bottom:11px}
 .field label{display:block;font-size:11px;color:var(--m);margin-bottom:4px}
 .field input,.field select{width:100%;padding:7px 9px;background:var(--s2);border:1px solid var(--b);border-radius:7px;color:var(--t);font-size:12px;outline:none}
@@ -56,14 +54,17 @@ header h1{font-size:18px;font-weight:700}header span{font-size:12px;color:var(--
 .sq{background:rgba(251,191,36,.15);color:#fbbf24}
 .sc{background:rgba(124,111,224,.2);color:#a78bfa}
 .sr{background:rgba(56,189,248,.15);color:#38bdf8}
+.su{background:rgba(255,157,0,.15);color:var(--hf)}
 .sd{background:rgba(74,222,128,.15);color:var(--g)}
 .se{background:rgba(248,113,113,.15);color:var(--r)}
 .prog-bar{height:4px;background:var(--s2);border-radius:99px;overflow:hidden;margin-bottom:8px}
 .prog-fill{height:100%;background:linear-gradient(90deg,var(--a),var(--a2));border-radius:99px;transition:width .3s}
-.job-actions{display:flex;gap:7px}
-.btn-sm{padding:5px 12px;border-radius:7px;font-size:11px;font-weight:600;cursor:pointer;border:none;transition:all .15s}
-.btn-dl{background:var(--g);color:#000}.btn-dl:hover{background:#22c55e}
+.job-actions{display:flex;gap:7px;flex-wrap:wrap;align-items:center}
+.btn-sm{padding:6px 14px;border-radius:7px;font-size:11px;font-weight:600;cursor:pointer;border:none;transition:all .15s;text-decoration:none;display:inline-flex;align-items:center;gap:5px}
+.btn-hf{background:var(--hf);color:#000}.btn-hf:hover{background:#e88e00}
+.btn-view{background:var(--s2);color:var(--t);border:1px solid var(--b)}.btn-view:hover{border-color:var(--a)}
 .btn-rt{background:var(--s2);color:var(--t);border:1px solid var(--b)}
+.hf-badge{font-size:10px;color:var(--hf);display:flex;align-items:center;gap:4px}
 .section-hdr{display:flex;align-items:center;justify-content:space-between;margin-bottom:14px}
 .section-hdr h2{font-size:15px;font-weight:700}
 .section-hdr span{font-size:11px;color:var(--m)}
@@ -73,13 +74,14 @@ header h1{font-size:18px;font-weight:700}header span{font-size:12px;color:var(--
 input[type=range]{accent-color:var(--a);cursor:pointer;width:100%}
 .toast{position:fixed;bottom:20px;right:20px;padding:10px 16px;background:var(--s);border:1px solid var(--b);border-radius:var(--rad);font-size:12px;z-index:999;animation:tin .2s ease}
 @keyframes tin{from{opacity:0;transform:translateY(6px)}to{opacity:1;transform:translateY(0)}}
+.repo-banner{background:rgba(255,157,0,.08);border:1px solid rgba(255,157,0,.25);border-radius:8px;padding:8px 12px;font-size:11px;color:var(--hf);display:flex;align-items:center;gap:6px;margin-bottom:12px}
 </style>
 </head>
 <body>
 <header>
   <div class="dot"></div>
-  <h1>🎬 Dee Video Studio</h1>
-  <span>HyperFrames · Cloud Render · AI-powered</span>
+  <h1>🎬 Hyperframes Video Studio</h1>
+  <span>HyperFrames · HuggingFace Cloud · AI-powered</span>
 </header>
 <div class="layout">
 <div class="sidebar">
@@ -123,36 +125,61 @@ input[type=range]{accent-color:var(--a);cursor:pointer;width:100%}
       <input type="range" id="mvol" min="0" max="100" value="30" oninput="document.getElementById('vl').textContent=this.value+'%'">
     </div>
   </div>
-  <button class="render-btn" id="rb" onclick="startRender()">▶ Render Video</button>
+  <button class="render-btn" id="rb" onclick="startRender()">▶ Render &amp; Upload to HuggingFace</button>
 </div>
 <div class="main">
+  <div id="repo-banner" class="repo-banner" style="display:none">
+    🤗 Renders save to: <a id="repo-link" href="#" target="_blank" style="color:var(--hf);font-weight:600"></a>
+  </div>
   <div class="section-hdr">
     <h2>Render Queue</h2>
     <span id="jc">0 jobs</span>
   </div>
   <div id="jlist">
-    <div class="empty"><div class="ei">🎬</div><p>Upload assets and hit Render to create your first video.</p></div>
+    <div class="empty"><div class="ei">🎬</div><p>Upload assets and hit Render — your video will be saved directly to HuggingFace.</p></div>
   </div>
 </div>
 </div>
 <script>
 const API='';
 let wf='testimonial', files=[], jobs={};
+const RENDERS_REPO = 'AIgoose/video-renders';
 
 async function init(){
+  // Show repo banner
+  const banner = document.getElementById('repo-banner');
+  const link = document.getElementById('repo-link');
+  link.href = `https://huggingface.co/datasets/${RENDERS_REPO}`;
+  link.textContent = `datasets/${RENDERS_REPO}`;
+  banner.style.display = 'flex';
+
   try{
-    const [wfs,tracks]=await Promise.all([fetch(API+'/api/workflows').then(r=>r.json()),fetch(API+'/api/music').then(r=>r.json())]);
-    document.getElementById('wf-grid').innerHTML=wfs.map(w=>`<button class="wf-pill ${w.id===wf?'active':''}" onclick="selWf('${w.id}')"><span class="icon">${w.icon}</span><span class="name">${w.name}</span><span class="desc">${w.description}</span></button>`).join('');
+    const [wfs,tracks]=await Promise.all([
+      fetch(API+'/api/workflows').then(r=>r.json()),
+      fetch(API+'/api/music').then(r=>r.json())
+    ]);
+    document.getElementById('wf-grid').innerHTML=wfs.map(w=>`
+      <button class="wf-pill ${w.id===wf?'active':''}" onclick="selWf('${w.id}')">
+        <span class="icon">${w.icon}</span>
+        <span class="name">${w.name}</span>
+        <span class="desc">${w.description}</span>
+      </button>`).join('');
     const mg=document.getElementById('mg');
-    mg.innerHTML=`<label class="music-item sel"><input type="radio" name="music" value="auto" checked><div class="mi-info"><div class="mi-name">🤖 Auto-select</div><div class="mi-tags">Matches your workflow</div></div></label>`
-      +tracks.map(t=>`<label class="music-item"><input type="radio" name="music" value="${t.file}"><div class="mi-info"><div class="mi-name">${moji(t.mood)} ${cap(t.mood)}</div><div class="mi-tags">${(t.tags||[]).slice(0,3).join(' · ')}</div></div><div class="mi-bpm">${t.bpm} bpm</div></label>`).join('');
-    mg.querySelectorAll('.music-item').forEach(el=>el.addEventListener('click',()=>{mg.querySelectorAll('.music-item').forEach(x=>x.classList.remove('sel'));el.classList.add('sel');}));
+    mg.innerHTML=`<label class="music-item sel"><input type="radio" name="music" value="auto" checked>
+      <div class="mi-info"><div class="mi-name">🤖 Auto-select</div><div class="mi-tags">Matches your workflow</div></div></label>`
+      +tracks.map(t=>`<label class="music-item"><input type="radio" name="music" value="${t.file}">
+        <div class="mi-info"><div class="mi-name">${moji(t.mood)} ${cap(t.mood)}</div><div class="mi-tags">${(t.tags||[]).slice(0,3).join(' · ')}</div></div>
+        <div class="mi-bpm">${t.bpm} bpm</div></label>`).join('');
+    mg.querySelectorAll('.music-item').forEach(el=>el.addEventListener('click',()=>{
+      mg.querySelectorAll('.music-item').forEach(x=>x.classList.remove('sel'));
+      el.classList.add('sel');
+    }));
   }catch(e){console.warn('Init error',e)}
 }
 
 function moji(m){return{corporate:'🏢',cinematic:'🎬',upbeat:'⚡',warm:'🤝',tech:'🤖',energetic:'🔥'}[m]||'🎵'}
 function cap(s){return s?s[0].toUpperCase()+s.slice(1):''}
-function selWf(id){wf=id;document.querySelectorAll('.wf-pill').forEach(el=>el.classList.toggle('active',el.getAttribute('onclick')===`selWf('${id}')`))}
+function selWf(id){wf=id;document.querySelectorAll('.wf-pill').forEach(el=>el.classList.toggle('active',el.getAttribute('onclick')===`selWf('${id}')`))} 
 
 const dz=document.getElementById('dz');
 const fi=document.getElementById('fi');
@@ -166,7 +193,12 @@ function addFiles(f){files.push(...f);renderFL()}
 function removeFile(i){files.splice(i,1);renderFL()}
 function renderFL(){
   const l=document.getElementById('fl');
-  l.innerHTML=files.map((f,i)=>`<div class="file-item"><span>${ficon(f.type)}</span><span class="fi-name">${f.name}</span><span class="fi-size">${fsz(f.size)}</span><button class="fi-rm" onclick="removeFile(${i})">✕</button></div>`).join('');
+  l.innerHTML=files.map((f,i)=>`<div class="file-item">
+    <span>${ficon(f.type)}</span>
+    <span class="fi-name">${f.name}</span>
+    <span class="fi-size">${fsz(f.size)}</span>
+    <button class="fi-rm" onclick="removeFile(${i})">✕</button>
+  </div>`).join('');
 }
 function ficon(m){if(m.startsWith('video/'))return'🎥';if(m.startsWith('image/'))return'🖼️';if(m.startsWith('audio/'))return'🎵';return'📄'}
 function fsz(b){return b>1024*1024?(b/1024/1024).toFixed(1)+'MB':(b/1024).toFixed(0)+'KB'}
@@ -183,8 +215,12 @@ async function startRender(){
   try{
     const res=await fetch(API+'/api/render',{method:'POST',body:fd});
     const {jobId}=await res.json();
-    jobs[jobId]={id:jobId,status:'queued',progress:0,projectName:document.getElementById('clientName').value||'Untitled',workflow:wf,createdAt:Date.now()};
-    renderJobs();connectWS(jobId);toast('✅ Render started!');
+    jobs[jobId]={
+      id:jobId,status:'queued',progress:0,
+      projectName:document.getElementById('clientName').value||'Untitled',
+      workflow:wf,createdAt:Date.now()
+    };
+    renderJobs();connectWS(jobId);toast('✅ Render started — will upload to HuggingFace when done!');
   }catch(e){toast('❌ '+e.message)}
   finally{rb.disabled=false}
 }
@@ -192,29 +228,52 @@ async function startRender(){
 function connectWS(jobId){
   const p=location.protocol==='https:'?'wss':'ws';
   const s=new WebSocket(`${p}://${location.host}?job=${jobId}`);
-  s.onmessage=e=>{Object.assign(jobs[jobId]||{},JSON.parse(e.data));if(!jobs[jobId])jobs[jobId]=JSON.parse(e.data);renderJobs();const d=JSON.parse(e.data);if(d.status==='done'||d.status==='error')s.close()};
+  s.onmessage=e=>{
+    const d=JSON.parse(e.data);
+    if(!jobs[jobId])jobs[jobId]=d;
+    else Object.assign(jobs[jobId],d);
+    renderJobs();
+    if(d.status==='done'||d.status==='error')s.close();
+  };
 }
 
 function renderJobs(){
   const c=document.getElementById('jlist');
   const list=Object.values(jobs).sort((a,b)=>b.createdAt-a.createdAt);
   document.getElementById('jc').textContent=`${list.length} job${list.length!==1?'s':''}`;
-  if(!list.length){c.innerHTML='<div class="empty"><div class="ei">🎬</div><p>Upload assets and hit Render to create your first video.</p></div>';return}
-  const cls={queued:'sq',composing:'sc',rendering:'sr',done:'sd',error:'se'};
+  if(!list.length){
+    c.innerHTML='<div class="empty"><div class="ei">🎬</div><p>Upload assets and hit Render — your video will be saved directly to HuggingFace.</p></div>';
+    return;
+  }
+  const cls={queued:'sq',composing:'sc',rendering:'sr',uploading:'su',done:'sd',error:'se'};
+  const labels={queued:'Queued',composing:'Composing',rendering:'Rendering',uploading:'Uploading to HF 🤗',done:'Done ✓',error:'Error'};
   c.innerHTML=list.map(j=>`<div class="job-item">
-    <div class="job-header"><div><div class="job-name">${j.projectName||'Untitled'} · ${j.workflow||''}</div><div class="job-meta">${new Date(j.createdAt).toLocaleTimeString()} · ${(j.id||'').slice(0,8)}…</div></div>
-    <span class="sbadge ${cls[j.status]||'sq'}">${j.status}</span></div>
+    <div class="job-header">
+      <div>
+        <div class="job-name">${j.projectName||'Untitled'} · ${j.workflow||''}</div>
+        <div class="job-meta">${new Date(j.createdAt).toLocaleTimeString()} · ${(j.id||'').slice(0,8)}…</div>
+      </div>
+      <span class="sbadge ${cls[j.status]||'sq'}">${labels[j.status]||j.status}</span>
+    </div>
     <div class="prog-bar"><div class="prog-fill" style="width:${j.progress||0}%"></div></div>
     <div class="job-actions">
-      ${j.status==='done'?`<button class="btn-sm btn-dl" onclick="dl('${j.id}')">⬇ Download MP4</button>`:''}
-      ${j.status==='error'?`<span style="font-size:11px;color:var(--r)">${j.error}</span>`:''}
-    </div></div>`).join('');
+      ${j.status==='done'&&j.hf_url ? `
+        <a class="btn-sm btn-hf" href="${j.hf_url}" target="_blank">🤗 Open on HuggingFace</a>
+        <a class="btn-sm btn-view" href="${j.viewer_url||j.hf_url}" target="_blank">👁 View file</a>
+        <span class="hf-badge">📁 ${j.hf_filename||''}</span>
+      ` : ''}
+      ${j.status==='done'&&!j.hf_url ? `
+        <a class="btn-sm btn-view" href="/api/download/${j.id}" target="_blank">⬇ Download MP4</a>
+        <span style="font-size:10px;color:var(--m)">Saved locally (HF upload failed)</span>
+      ` : ''}
+      ${j.status==='error' ? `<span style="font-size:11px;color:var(--r)">${j.error}</span>` : ''}
+    </div>
+  </div>`).join('');
 }
 
-function dl(id){window.open(API+'/api/download/'+id,'_blank')}
-function toast(msg){const el=document.createElement('div');el.className='toast';el.textContent=msg;document.body.appendChild(el);setTimeout(()=>el.remove(),3000)}
+function toast(msg){const el=document.createElement('div');el.className='toast';el.textContent=msg;document.body.appendChild(el);setTimeout(()=>el.remove(),3500)}
 
 init();
 </script>
 </body>
-</html>
+</html>

uploader.py

@@ -0,0 +1,56 @@
+#!/usr/bin/env python3
+"""
+uploader.py — Upload a rendered MP4 to HuggingFace Dataset repo.
+Called from Node.js as a child process:
+  python3 uploader.py <local_mp4_path> <remote_filename> <hf_token>
+Prints JSON result to stdout.
+"""
+import sys, json, os
+from huggingface_hub import HfApi
+
+def main():
+    if len(sys.argv) < 4:
+        print(json.dumps({"error": "Usage: uploader.py <path> <filename> <token>"}))
+        sys.exit(1)
+
+    local_path = sys.argv[1]
+    remote_filename = sys.argv[2]
+    hf_token = sys.argv[3]
+
+    REPO_ID = os.environ.get("HF_RENDERS_REPO", "AIgoose/video-renders")
+    REPO_TYPE = "dataset"
+
+    try:
+        api = HfApi(token=hf_token)
+
+        # Ensure the dataset repo exists (create if not)
+        try:
+            api.repo_info(repo_id=REPO_ID, repo_type=REPO_TYPE)
+        except Exception:
+            api.create_repo(repo_id=REPO_ID, repo_type=REPO_TYPE, private=False, exist_ok=True)
+
+        # Upload the file
+        url = api.upload_file(
+            path_or_fileobj=local_path,
+            path_in_repo=f"renders/{remote_filename}",
+            repo_id=REPO_ID,
+            repo_type=REPO_TYPE,
+            commit_message=f"render: {remote_filename}",
+        )
+
+        hf_url = f"https://huggingface.co/datasets/{REPO_ID}/resolve/main/renders/{remote_filename}"
+        viewer_url = f"https://huggingface.co/datasets/{REPO_ID}/blob/main/renders/{remote_filename}"
+
+        print(json.dumps({
+            "success": True,
+            "hf_url": hf_url,
+            "viewer_url": viewer_url,
+            "repo_id": REPO_ID,
+            "filename": remote_filename,
+        }))
+    except Exception as e:
+        print(json.dumps({"error": str(e)}))
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()