feat: Add multiple free AI tools to the workflow, including upscaler, image generation, and text-to-3D, and update the README to document them.

README.md

@@ -1,33 +1,63 @@
 ---
-title: Imageat Workflow
-emoji: 📚
-colorFrom: gray
-colorTo: purple
+title: Imageat Workflow - Free Tools
+emoji: 🎨
+colorFrom: purple
+colorTo: blue
 sdk: gradio
 sdk_version: 6.5.1
 app_file: app.py
 pinned: false
 license: mit
-short_description: Daggr workflow engine – image processing & AI nodes for Next
+short_description: Free AI tools - Background Removal, Upscaler, FLUX, Z-Image, Text to 3D
 ---
 
-Daggr workflow (background removal, etc.) for use from the Next.js app.
+# Imageat Workflow - Free AI Tools
 
-## Using this Space from the API (Next.js app)
+Collection of **free AI tools** powered by Daggr for use with the Imageat Next.js application.
 
-The Space must run with **Gradio** SDK so `@gradio/client` can connect (it needs JSON config, not HTML).
+## 🎨 Available Free Tools
 
-### If you see "Unexpected token '<', \"<!DOCTYPE\"..." when calling the API
+| Tool | Description | Input | Output |
+|------|-------------|-------|--------|
+| **Background Removal** | Remove background from images using AI | Image | Image |
+| **Image Upscaler** | Enhance image resolution with AI upscaling | Image | Image |
+| **Z-Image Turbo** | Fast image generation with Tongyi Z-Image model | Prompt | Image |
+| **FLUX.2 Klein 9B** | Generate images with Black Forest Labs FLUX.2 model | Prompt | Image |
+| **Text to 3D** | Transform text prompts into 3D models | Prompt | 3D Model |
 
-1. **Check README.md** – At the root of this repo, the first line block must contain:
-   ```yaml
-   sdk: gradio
-   app_file: app.py
-   ```
-2. **Push to the Space** – Commit and push this README (and the rest of the repo) to the Space so Hugging Face rebuilds from it.
-3. **Space settings** – On [your Space](https://huggingface.co/spaces/incendies/imageat-workflow), open **Settings** (or the Space’s **Files**). The SDK is read from the **README.md** YAML; you cannot change SDK in the UI, only via that file. Ensure there is no `sdk: docker` in README.
-4. **Rebuild** – After pushing `sdk: gradio`, the Space will rebuild. Wait until it shows **Running** (not “Fetching metadata from the HF Docker repository”). Then the Next.js app can call this Space first for background removal.
+## 🔗 Underlying Spaces
 
-**Hâlâ HTML hatası alıyorsan:** Space ilk kurulurken Docker seçilmiş olabilir; HF bazen README ile runtime değiştirmiyor. [Space Settings](https://huggingface.co/spaces/incendies/imageat-workflow/settings) → **Factory reboot** dene. Olmazsa [yeni Space oluştur](https://huggingface.co/new-space), **SDK: Gradio** seç, aynı dosyaları push et; Next.js API'de Space adını güncelle.
+These tools connect to the following HuggingFace Spaces:
+
+- `hf-applications/background-removal` - GPU-accelerated background removal
+- `Phips/Upscaler` - AI image upscaling with multiple models
+- `hf-applications/Z-Image-Turbo` - Fast image generation
+- `black-forest-labs/FLUX.2-klein-9B` - FLUX.2 Klein 9B model
+- `hysts-daggr/daggr-text-to-image-to-3d` - Text to 3D pipeline
+
+## 📡 API Usage
+
+This Space is designed to be called from the Next.js app via `@gradio/client`.
+
+### Example API Call
+
+```typescript
+import { Client } from "@gradio/client";
+
+const client = await Client.connect("incendies/imageat-workflow");
+const result = await client.predict("/image", { image: myImageBlob });
+```
+
+## 🛠️ Configuration
+
+The Space must run with **Gradio** SDK so `@gradio/client` can connect.
+
+### Troubleshooting
+
+If you see "Unexpected token '<', \"<!DOCTYPE\"..." when calling the API:
+
+1. Ensure `sdk: gradio` is in this README's frontmatter
+2. Push changes and wait for rebuild
+3. Space must show **Running** status before API calls work
 
 [Spaces configuration reference](https://huggingface.co/docs/hub/spaces-config-reference)

app.py

@@ -1,8 +1,12 @@
 import gradio as gr
 from daggr import GradioNode, Graph
 
-# Background removal: API returns (original, processed). Hide first with None, show final_image.
-# hf-applications/background-removal runs on GPU (Zero); use merve/background-removal for CPU.
+# ==================== FREE TOOLS COLLECTION ====================
+# These tools are free to use and don't consume credits
+
+# 1. Background Removal
+# API returns (original, processed). Hide first with None, show final_image.
+# hf-applications/background-removal runs on GPU (Zero)
 bg_remover = GradioNode(
     "hf-applications/background-removal",
     api_name="/image",
@@ -10,10 +14,79 @@ bg_remover = GradioNode(
     inputs={"image": gr.Image()},
     outputs={
         "original_image": None,
-        "final_image": gr.Image(label="Processed Image"),
+        "final_image": gr.Image(label="Background Removed"),
+    },
+)
+
+# 2. Image Upscaler
+# Phips/Upscaler - Enhance image resolution with AI upscaling
+upscaler = GradioNode(
+    "Phips/Upscaler",
+    api_name="/predict",
+    run_locally=False,
+    inputs={
+        "image": gr.Image(),
+    },
+    outputs={
+        "upscaled_image": gr.Image(label="Upscaled Image"),
     },
 )
 
-# Add more nodes here (Video Gen, Watermark Remover, etc.) as needed
-graph = Graph(name="Imageat Workflow", nodes=[bg_remover])
+# 3. Z-Image Turbo
+# hf-applications/Z-Image-Turbo - Fast image generation
+z_image_turbo = GradioNode(
+    "hf-applications/Z-Image-Turbo",
+    api_name="/predict",
+    run_locally=False,
+    inputs={
+        "prompt": gr.Textbox(label="Prompt"),
+    },
+    outputs={
+        "generated_image": gr.Image(label="Generated Image"),
+    },
+)
+
+# 4. FLUX.2 Klein 9B
+# black-forest-labs/FLUX.2-klein-9B - Generate or edit images with FLUX.2 Klein model
+flux_klein = GradioNode(
+    "black-forest-labs/FLUX.2-klein-9B",
+    api_name="/generate",
+    run_locally=False,
+    inputs={
+        "prompt": gr.Textbox(label="Prompt"),
+    },
+    outputs={
+        "result": gr.Image(label="Generated Image"),
+        "seed_output": None,
+    },
+)
+
+# 5. Text to Image to 3D (Daggr)
+# hysts-daggr/daggr-text-to-image-to-3d - Transform text prompts into 3D models
+text_to_3d = GradioNode(
+    "hysts-daggr/daggr-text-to-image-to-3d",
+    api_name="/predict",
+    run_locally=False,
+    inputs={
+        "prompt": gr.Textbox(label="Prompt"),
+    },
+    outputs={
+        "result": gr.Model3D(label="3D Model"),
+    },
+)
+
+# ==================== GRAPH SETUP ====================
+# Create the workflow graph with all free tools
+graph = Graph(
+    name="Imageat Workflow - Free Tools",
+    nodes=[
+        bg_remover,
+        upscaler,
+        z_image_turbo,
+        flux_klein,
+        text_to_3d,
+    ]
+)
+
+# Launch the Space
 graph.launch()