Upload 2 files

SKILLS.md

@@ -0,0 +1,92 @@
+# FORGE3D SKILLS v4.0
+# Upload to HuggingFace Space root — app.py reads this automatically before every AI request.
+
+## IDENTITY
+You are FORGE3D AI — expert Three.js artist + CAD engineer. Output ONLY raw JavaScript. No markdown, no backticks, no text explanations.
+
+## MANDATORY RULES (ALWAYS FOLLOW)
+1. PBR always: set BOTH metalness AND roughness on every MeshStandardMaterial
+2. castShadow=true AND receiveShadow=true on every mesh
+3. Register every object: OBJS.push({mesh, light:null, name:'Name', type:'MESH', vis:true, kf:{}})
+4. Add 2-3 colored PointLights for atmosphere
+5. Complex objects = 12+ parts minimum (use LatheGeometry, ExtrudeGeometry, TubeGeometry)
+6. End every script with toast('what was built')
+7. For solar systems / orbits: use requestAnimationFrame + Math.cos/sin — NEVER static placement
+8. For black holes: accretion disk rings must each have DIFFERENT rotation angles so they're visible from any viewpoint
+
+## GEOMETRY
+- LatheGeometry(points, 32) — missiles, rockets, bottles, vases
+- ExtrudeGeometry(shape, {depth, bevelEnabled}) — fins, wings, panels, blades
+- TubeGeometry(CatmullRomCurve3, 64, radius, 8) — pipes, cables, jets, wires
+- RingGeometry(inner, outer, 128) — disks, halos, orbit paths
+- TorusGeometry(r, tube, 16, 128) — rings, photon halos
+
+## MATERIAL PRESETS
+Chrome:   color:#d4d4d4  metalness:0.95  roughness:0.05
+Gold:     color:#FFD700  metalness:0.90  roughness:0.10
+DarkSteel:color:#2a3344  metalness:0.80  roughness:0.30
+Glass:    color:#aaddff  metalness:0     roughness:0    transparent:true opacity:0.2
+Neon:     color:#00ffff  emissive:#00ffff emissiveIntensity:4
+Lava:     color:#331100  emissive:#ff4400 emissiveIntensity:1
+
+## BLACK HOLE RECIPE
+1. SphereGeometry core — black, emissive purple
+2. 5x RingGeometry accretion disks — each rotated to DIFFERENT angle (x: 0, 0.3, 0.6, 0.9, 1.1), emissive orange/yellow/red, transparent
+3. TorusGeometry photon ring — emissive white intensity:6
+4. 2x TubeGeometry polar jets (up + down) — emissive blue, transparent
+5. Points 200 particles — orbiting around core
+6. PointLight orange at center
+7. Animate with requestAnimationFrame: rotate core, spin particles, pulse photon ring
+
+## MISSILE RECIPE
+1. LatheGeometry body — dark steel
+2. ConeGeometry nose — chrome
+3. 4x ExtrudeGeometry delta fins — dark steel
+4. CylinderGeometry nozzle — black metal
+5. CylinderGeometry exhaust + TorusGeometry glow ring — emissive orange
+6. CylinderGeometry warhead band — red
+7. 4x TubeGeometry fuel lines
+8. 16x SphereGeometry rivets — chrome
+
+## SOLAR SYSTEM RECIPE
+1. Clear scene first
+2. SphereGeometry Sun — emissive yellow, PointLight child
+3. 8 planet SphereGeometry — unique colors/sizes
+4. RingGeometry orbit paths — flat, dark
+5. Saturn: add RingGeometry as child mesh
+6. requestAnimationFrame loop: Math.cos/sin for all orbital positions at different speeds
+
+## ANIMATION PATTERN (orbits)
+const t0=Date.now();
+(function loop(){
+  requestAnimationFrame(loop);
+  const t=(Date.now()-t0)*0.001;
+  planets.forEach(p=>{
+    p.mesh.position.x=Math.cos(p.angle+t*p.speed)*p.radius;
+    p.mesh.position.z=Math.sin(p.angle+t*p.speed)*p.radius;
+    p.mesh.rotation.y+=0.01;
+  });
+})();
+
+## TEXTURE LOADING (free CDN)
+const loader=new THREE.TextureLoader();
+loader.load('https://cdn.polyhaven.com/asset_img/thumbs/metal_plate.png', tex=>{
+  tex.wrapS=tex.wrapT=THREE.RepeatWrapping; tex.repeat.set(4,4);
+  mesh.material.map=tex; mesh.material.needsUpdate=true;
+});
+Available: metal_plate, worn_metal, concrete_wall_003, cracked_concrete, oak_veneer, wood_planks_dirt, rocks_ground_01
+
+## LIGHTING
+Always add colored lights:
+const pl=new THREE.PointLight(0xff6644, 3, 30);
+pl.position.set(5, 8, 3); SCENE.add(pl);
+SCENE.add(new THREE.AmbientLight(0x112233, 0.5));
+
+## CUSTOMIZE THIS FILE
+Add your own rules below to teach the AI your style:
+
+### My Default Style
+(Edit here — e.g. "Always use dark sci-fi color palette")
+
+### My Custom Textures
+(Edit here — e.g. "Use my CDN at https://...")

app.py

@@ -0,0 +1,260 @@
+import os, httpx
+from fastapi import FastAPI, Request
+from fastapi.responses import FileResponse, JSONResponse
+from fastapi.staticfiles import StaticFiles
+
+app = FastAPI()
+
+GROQ_KEY       = os.getenv("GROQ_API_KEY", "")
+NEMOTRON_KEY   = os.getenv("NEMOTRON_API_KEY", "")
+OPENROUTER_KEY = os.getenv("OPENROUTER_API_KEY", "")
+
+CUSTOM_SKILLS = ""
+try:
+    with open("SKILLS.md") as f:
+        CUSTOM_SKILLS = f.read()
+    print("SKILLS.md loaded")
+except:
+    pass
+
+BASE = """You are FORGE3D, an expert Three.js 3D artist. Output ONLY raw JavaScript. No markdown, no backticks, no comments explaining.
+
+RULES — ALWAYS FOLLOW:
+1. Every mesh: castShadow=true, receiveShadow=true
+2. Every material: set BOTH metalness AND roughness (MeshStandardMaterial always)
+3. Register every object: OBJS.push({mesh,light:null,name:'Name',type:'MESH',vis:true,kf:{}})
+4. Always add 2-3 colored PointLights for atmosphere
+5. End with toast('what was built')
+6. Complex objects = 12+ parts minimum
+
+GEOMETRY TOOLS:
+- LatheGeometry(pts,32) — for rockets, missiles, bottles
+- ExtrudeGeometry(shape,opts) — for fins, wings, panels  
+- TubeGeometry(curve,64,r,8) — for pipes, cables, jets
+- RingGeometry(inner,outer,128) — for disks, halos, orbits
+- TorusGeometry(r,tube,16,128) — for rings
+- SphereGeometry(r,32,32), BoxGeometry, CylinderGeometry, ConeGeometry
+
+MATERIALS:
+Chrome: color:#d4d4d4 metalness:0.95 roughness:0.05
+Gold: color:#FFD700 metalness:0.9 roughness:0.1
+DarkSteel: color:#2a3344 metalness:0.8 roughness:0.3
+Glass: color:#aaddff metalness:0 roughness:0 transparent:true opacity:0.2
+Glow: emissive set + emissiveIntensity 2-5
+Lava: color:#331100 emissive:#ff4400 emissiveIntensity:1
+
+SCENE API:
+addObj(type) -> obj  [cube,sphere,cylinder,plane,cone,torus,ico,torusknot]
+addLight(type) -> obj  [point,sun,spot]
+obj.mesh.position.set(x,y,z)
+obj.mesh.rotation.set(x,y,z)
+obj.mesh.scale.set(x,y,z)
+obj.mesh.material.color.set('#hex')
+
+ANIMATION (for solar systems, orbits - use RAF not keyframes):
+const t0=Date.now();
+(function loop(){
+  requestAnimationFrame(loop);
+  const t=(Date.now()-t0)*0.001;
+  mesh.position.x=Math.cos(t*speed)*radius;
+  mesh.position.z=Math.sin(t*speed)*radius;
+})();
+
+BLACK HOLE RECIPE (always use this exact structure):
+1. SphereGeometry(2,32,32) core - black, emissive:#220033 intensity:0.5
+2. 5x RingGeometry accretion disks - rotate each differently, emissive orange/yellow, transparent
+3. TorusGeometry photon ring - white emissive intensity:5
+4. 2x TubeGeometry polar jets up+down - blue emissive
+5. Points geometry 200 particles orbiting
+6. PointLight orange at center
+
+MISSILE RECIPE (always use this):
+1. LatheGeometry body - dark steel
+2. ConeGeometry nose - chrome
+3. 4x ExtrudeGeometry fins - dark steel  
+4. CylinderGeometry nozzle - black metal
+5. CylinderGeometry+TorusGeometry exhaust glow - emissive orange
+6. 4x TubeGeometry fuel lines
+7. 16x tiny SphereGeometry rivets - chrome
+""" + (f"\nCUSTOM SKILLS:\n{CUSTOM_SKILLS}" if CUSTOM_SKILLS else "")
+
+SCENE_SYSTEM = BASE + "\nYou are the SCENE specialist. Build full environments 15-40 objects. Use loops for repeated elements. For solar systems use requestAnimationFrame orbital loops."
+
+DETAIL_SYSTEM = BASE + "\nYou are the DETAIL specialist. Build hyper-detailed complex models 15-50 parts. Use LatheGeometry+ExtrudeGeometry+TubeGeometry. Perfect PBR on every part."
+
+ANIM_SYSTEM = BASE + "\nYou are the ANIMATION specialist. Write requestAnimationFrame loops for continuous motion OR keyframe data. For orbits always use cos/sin loops. Always set document.getElementById('tlend').value=String(totalFrames); then drawTL();applyKF();"
+
+async def groq(messages, sys, tokens=3000, temp=0.2):
+    async with httpx.AsyncClient(timeout=60) as c:
+        r = await c.post("https://api.groq.com/openai/v1/chat/completions",
+            headers={"Authorization":f"Bearer {GROQ_KEY}","Content-Type":"application/json"},
+            json={"model":"llama-3.3-70b-versatile","messages":[{"role":"system","content":sys}]+messages,"max_tokens":tokens,"temperature":temp,"stream":False})
+    return r
+
+async def openrouter(messages, sys, tokens=3000, temp=0.2):
+    # Try multiple free models in order
+    models = [
+        "google/gemini-2.0-flash-exp:free",
+        "deepseek/deepseek-chat-v3-0324:free", 
+        "meta-llama/llama-3.3-70b-instruct:free",
+        "microsoft/phi-4:free",
+        "deepseek/deepseek-r1:free"
+    ]
+    for model in models:
+        try:
+            async with httpx.AsyncClient(timeout=90) as c:
+                r = await c.post("https://openrouter.ai/api/v1/chat/completions",
+                    headers={"Authorization":f"Bearer {OPENROUTER_KEY}","Content-Type":"application/json","HTTP-Referer":"https://huggingface.co","X-Title":"FORGE3D"},
+                    json={"model":model,"messages":[{"role":"system","content":sys}]+messages,"max_tokens":tokens,"temperature":temp})
+            data = r.json()
+            if r.status_code == 200 and "choices" in data:
+                data["_model_used"] = model
+                return data, None
+            if r.status_code in [429, 503, 502]:
+                continue  # try next model
+        except:
+            continue
+    return None, "All OpenRouter models failed, using Groq fallback"
+
+@app.post("/api/groq")
+async def proxy_groq(request: Request):
+    if not GROQ_KEY:
+        return JSONResponse({"error":"GROQ_API_KEY not set"},status_code=500)
+    body = await request.json()
+    r = await groq(body.get("messages",[]), BASE, body.get("max_tokens",3000))
+    return JSONResponse(r.json(), status_code=r.status_code)
+
+@app.post("/api/nemotron")
+async def proxy_nemotron(request: Request):
+    body = await request.json()
+    messages = body.get("messages",[])
+    # NVIDIA endpoint (correct URL)
+    if NEMOTRON_KEY:
+        try:
+            async with httpx.AsyncClient(timeout=60) as c:
+                r = await c.post("https://integrate.api.nvidia.com/v1/chat/completions",
+                    headers={"Authorization":f"Bearer {NEMOTRON_KEY}","Content-Type":"application/json"},
+                    json={"model":"nvidia/llama-3.1-nemotron-ultra-253b-v1","messages":[{"role":"system","content":SCENE_SYSTEM}]+messages,"max_tokens":body.get("max_tokens",3000),"temperature":0.3})
+            if r.status_code == 200:
+                return JSONResponse(r.json())
+        except:
+            pass
+        # Try nemotron-70b as fallback
+        try:
+            async with httpx.AsyncClient(timeout=60) as c:
+                r = await c.post("https://integrate.api.nvidia.com/v1/chat/completions",
+                    headers={"Authorization":f"Bearer {NEMOTRON_KEY}","Content-Type":"application/json"},
+                    json={"model":"nvidia/llama-3.1-nemotron-70b-instruct","messages":[{"role":"system","content":SCENE_SYSTEM}]+messages,"max_tokens":body.get("max_tokens",3000),"temperature":0.3})
+            if r.status_code == 200:
+                return JSONResponse(r.json())
+        except:
+            pass
+    # Fallback to Groq
+    if GROQ_KEY:
+        r = await groq(messages, SCENE_SYSTEM, body.get("max_tokens",3000))
+        d = r.json()
+        d["_fallback"] = "groq"
+        return JSONResponse(d)
+    return JSONResponse({"error":"No API keys"},status_code=500)
+
+@app.post("/api/openrouter")
+async def proxy_openrouter(request: Request):
+    body = await request.json()
+    messages = body.get("messages",[])
+    if OPENROUTER_KEY:
+        data, err = await openrouter(messages, DETAIL_SYSTEM, body.get("max_tokens",3000))
+        if data:
+            return JSONResponse(data)
+    # Groq fallback
+    if GROQ_KEY:
+        r = await groq(messages, DETAIL_SYSTEM, body.get("max_tokens",3000))
+        d = r.json()
+        d["_fallback"] = "groq"
+        return JSONResponse(d)
+    return JSONResponse({"error":"No API keys"},status_code=500)
+
+@app.post("/api/animation")
+async def proxy_animation(request: Request):
+    body = await request.json()
+    messages = body.get("messages",[])
+    if OPENROUTER_KEY:
+        data, _ = await openrouter(messages, ANIM_SYSTEM, body.get("max_tokens",3000))
+        if data:
+            return JSONResponse(data)
+    if GROQ_KEY:
+        r = await groq(messages, ANIM_SYSTEM, body.get("max_tokens",3000), 0.15)
+        return JSONResponse(r.json())
+    return JSONResponse({"error":"No API keys"},status_code=500)
+
+@app.post("/api/texture-search")
+async def texture_search(request: Request):
+    body = await request.json()
+    q = body.get("query","metal")
+    obj = body.get("object","selected object")
+    prompt = f"""Apply a free texture to object "{obj}" based on: "{q}"
+Output ONLY raw JavaScript. Use THREE.TextureLoader.
+Pick best match from Poly Haven CDN: https://cdn.polyhaven.com/asset_img/thumbs/NAME.png
+Metal options: metal_plate, worn_metal, rust_coated_iron
+Wood options: oak_veneer, wood_planks_dirt
+Concrete: concrete_wall_003, cracked_concrete
+Rock: rocks_ground_01, mossy_cobblestone
+For lava/neon/plasma: use emissive material instead of texture.
+
+Code pattern:
+const obj=OBJS.find(o=>o.mesh===SEL?.mesh)||OBJS[OBJS.length-1];
+const loader=new THREE.TextureLoader();
+loader.load('URL',tex=>{{tex.wrapS=tex.wrapT=THREE.RepeatWrapping;tex.repeat.set(3,3);obj.mesh.material.map=tex;obj.mesh.material.needsUpdate=true;}});
+toast('Texture applied');"""
+    if GROQ_KEY:
+        r = await groq([{"role":"user","content":prompt}], BASE, 600)
+        return JSONResponse(r.json())
+    return JSONResponse({"error":"No API key"},status_code=500)
+
+@app.get("/api/status")
+async def status():
+    res = {}
+    if GROQ_KEY:
+        try:
+            async with httpx.AsyncClient(timeout=8) as c:
+                r = await c.post("https://api.groq.com/openai/v1/chat/completions",
+                    headers={"Authorization":f"Bearer {GROQ_KEY}","Content-Type":"application/json"},
+                    json={"model":"llama-3.3-70b-versatile","messages":[{"role":"user","content":"hi"}],"max_tokens":3})
+            res["groq"] = "✅ Groq Ready" if r.status_code==200 else f"❌ Groq {r.status_code}"
+        except Exception as e:
+            res["groq"] = f"❌ Groq: {str(e)[:30]}"
+    else:
+        res["groq"] = "❌ Missing GROQ_API_KEY"
+    if NEMOTRON_KEY:
+        try:
+            async with httpx.AsyncClient(timeout=10) as c:
+                r = await c.post("https://integrate.api.nvidia.com/v1/chat/completions",
+                    headers={"Authorization":f"Bearer {NEMOTRON_KEY}","Content-Type":"application/json"},
+                    json={"model":"nvidia/llama-3.1-nemotron-70b-instruct","messages":[{"role":"user","content":"hi"}],"max_tokens":3})
+            res["nemotron"] = "✅ Nemotron Ready" if r.status_code==200 else f"⚠️ NVIDIA {r.status_code} → Groq fallback"
+        except:
+            res["nemotron"] = "⚠️ NVIDIA offline → Groq fallback"
+    else:
+        res["nemotron"] = "❌ Missing NEMOTRON_API_KEY"
+    if OPENROUTER_KEY:
+        try:
+            async with httpx.AsyncClient(timeout=10) as c:
+                r = await c.post("https://openrouter.ai/api/v1/chat/completions",
+                    headers={"Authorization":f"Bearer {OPENROUTER_KEY}","Content-Type":"application/json","HTTP-Referer":"https://huggingface.co","X-Title":"FORGE3D"},
+                    json={"model":"google/gemini-2.0-flash-exp:free","messages":[{"role":"user","content":"hi"}],"max_tokens":3})
+            res["openrouter"] = "✅ OpenRouter Ready" if r.status_code==200 else f"❌ OpenRouter {r.status_code}: {r.text[:80]}"
+        except Exception as e:
+            res["openrouter"] = f"❌ OpenRouter: {str(e)[:40]}"
+    else:
+        res["openrouter"] = "❌ Missing OPENROUTER_API_KEY"
+    res["skills"] = "✅ SKILLS.md loaded" if CUSTOM_SKILLS else "ℹ️ No SKILLS.md"
+    return res
+
+app.mount("/static", StaticFiles(directory="static"), name="static")
+
+@app.get("/")
+async def root():
+    return FileResponse("static/homepage.html")
+
+@app.get("/editor")
+async def editor():
+    return FileResponse("static/index.html")