Upload folder using huggingface_hub

README.md

@@ -1,10 +1,10 @@
 ---
 title: Eruku - Styled Text Generation
 emoji: 🖋️
-colorFrom: purple
-colorTo: blue
+colorFrom: indigo
+colorTo: purple
 sdk: gradio
-sdk_version: 4.44.0
+sdk_version: 4.44.1
 app_file: app.py
 pinned: true
 license: apache-2.0
@@ -15,51 +15,44 @@ tags:
   - styled-text
   - text-to-image
   - autoregressive
+  - WACV2026
 short_description: Generate handwritten text in any style
 ---
 
-# Eruku - Autoregressive Styled Text Image Generation
+# 🖋️ Eruku - Autoregressive Styled Text Image Generation
 
-This Space demonstrates **Eruku**, a state-of-the-art model for generating handwritten and styled text images.
+**Autoregressive Styled Text Image Generation, but Make it Reliable**
 
-## Features
+WACV 2026 | [Paper](https://arxiv.org/abs/2510.23240) | [Project Page](https://eruku.carminezacc.com) | [Model](https://huggingface.co/blowing-up-groundhogs/eruku)
 
-- **Zero-shot style transfer**: No training needed for new styles
-- **No transcription required**: Works with just a style image
-- **Reliable generation**: Proper EOG mechanism prevents artifacts
-- **Arbitrary length**: Generate text of any length
+## Key Features
+
+- **🎯 Optional Style Text**: Unlike previous methods, Eruku works without requiring transcription of the style image
+- **🛑 Explicit Stopping**: Dedicated end-of-generation token prevents repetition artifacts
+- **✨ CFG-Guided**: Classifier-Free Guidance for better text adherence
 
 ## How to Use
 
-1. Upload a handwriting or font sample as the style image
-2. Optionally enter the text from the style image
+1. Upload a handwriting sample as the style image
+2. Optionally enter the text from the style image (helps but not required!)
 3. Enter the text you want to generate
 4. Click Generate!
 
 ## Citation
 
 ```bibtex
-@InProceedings{pippi2025zeroshot,
-    author    = {Pippi, Vittorio and Quattrini, Fabio and Cascianelli, Silvia and Tonioni, Alessio and Cucchiara, Rita},
-    title     = {Zero-Shot Styled Text Image Generation, but Make It Autoregressive},
-    booktitle = {Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},
-    month     = {June},
-    year      = {2025},
-    pages     = {7910-7919}
-}
-
-@inproceedings{zaccagnino2026autoregressive,
-    author = {Carmine Zaccagnino and Fabio Quattrini and Vittorio Pippi and Silvia Cascianelli and Alessio Tonioni and Rita Cucchiara},
-    title = {Autoregressive Styled Text Image Generation, but Make it Reliable},
-    booktitle = {Proceedings of the IEEE/CVF Winter Conference on Applications of Computer Vision},
-    month = {March},
-    year = {2026}
+@inproceedings{zaccagnino2026eruku,
+    title={{Autoregressive Styled Text Image Generation, but Make it Reliable}},
+    author={Zaccagnino, Carmine and Quattrini, Fabio and Pippi, Vittorio 
+            and Cascianelli, Silvia and Tonioni, Alessio and Cucchiara, Rita},
+    booktitle={Proceedings of the IEEE/CVF Winter Conference on 
+               Applications of Computer Vision (WACV)},
+    year={2026}
 }
 ```
 
-## Links
+## Authors
 
-- 📄 [Paper](https://arxiv.org/abs/2510.23240)
-- 🌐 [Website](https://eruku.carminezacc.com)
-- 🤗 [Model](https://huggingface.co/blowing-up-groundhogs/eruku)
+Carmine Zaccagnino, Fabio Quattrini, Vittorio Pippi, Silvia Cascianelli, Alessio Tonioni, Rita Cucchiara
 
+University of Modena and Reggio Emilia | Google

app.py

@@ -1,5 +1,6 @@
 """
-Eruku Demo - Autoregressive Styled Text Image Generation
+Eruku Demo - Autoregressive Styled Text Image Generation, but Make it Reliable
+WACV 2026
 """
 
 import gradio as gr
@@ -100,24 +101,166 @@ def generate_handwriting(style_image, style_text, gen_text):
         return None, f"❌ Error: {str(e)}"
 
 
-# Create interface
-demo = gr.Interface(
-    fn=generate_handwriting,
-    inputs=[
-        gr.Image(label="Style Image", type="pil"),
-        gr.Textbox(label="Style Text (Optional)", lines=2, placeholder="Text in the style image"),
-        gr.Textbox(label="Text to Generate", lines=3, value="Hello, World!"),
-    ],
-    outputs=[
-        gr.Image(label="Generated Output", type="pil"),
-        gr.Textbox(label="Status"),
-    ],
-    title="🖋️ Eruku - Styled Text Generation",
-    description="Generate handwritten text in any style. Upload a handwriting sample, then enter what you want to generate.",
-    article="[Paper](https://arxiv.org/abs/2510.23240) | [Model](https://huggingface.co/blowing-up-groundhogs/eruku)",
-    examples=load_examples(),
-    cache_examples=False,
-)
+# Custom CSS for better styling
+custom_css = """
+.gradio-container {
+    max-width: 1200px !important;
+}
+.header-text {
+    text-align: center;
+    margin-bottom: 1rem;
+}
+.feature-box {
+    background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+    border-radius: 10px;
+    padding: 15px;
+    margin: 10px 0;
+}
+footer {
+    visibility: hidden;
+}
+"""
+
+# Build the interface with gr.Blocks for better customization
+with gr.Blocks(css=custom_css, title="Eruku - Styled Text Generation") as demo:
+    
+    # Header
+    gr.HTML("""
+    <div style="text-align: center; margin-bottom: 20px;">
+        <h1>🖋️ Eruku</h1>
+        <h3 style="color: #888; font-weight: normal;">Autoregressive Styled Text Image Generation, but Make it Reliable</h3>
+        <p style="color: #666;">
+            <strong>WACV 2026</strong> &nbsp;|&nbsp;
+            Carmine Zaccagnino, Fabio Quattrini, Vittorio Pippi, Silvia Cascianelli, Alessio Tonioni, Rita Cucchiara
+        </p>
+        <p>
+            <a href="https://arxiv.org/abs/2510.23240" target="_blank">📄 Paper</a> &nbsp;|&nbsp;
+            <a href="https://eruku.carminezacc.com" target="_blank">🌐 Project Page</a> &nbsp;|&nbsp;
+            <a href="https://huggingface.co/blowing-up-groundhogs/eruku" target="_blank">🤗 Model</a> &nbsp;|&nbsp;
+            <a href="https://github.com/aimagelab/Emuru" target="_blank">💻 Code</a>
+        </p>
+    </div>
+    """)
+    
+    # Key features
+    gr.HTML("""
+    <div style="display: flex; justify-content: center; gap: 20px; flex-wrap: wrap; margin-bottom: 20px;">
+        <div style="background: #1e3a5f; padding: 10px 20px; border-radius: 8px; text-align: center;">
+            <strong>🎯 Optional Style Text</strong><br>
+            <small>Works without transcription</small>
+        </div>
+        <div style="background: #1e3a5f; padding: 10px 20px; border-radius: 8px; text-align: center;">
+            <strong>🛑 Explicit Stopping</strong><br>
+            <small>No repetition artifacts</small>
+        </div>
+        <div style="background: #1e3a5f; padding: 10px 20px; border-radius: 8px; text-align: center;">
+            <strong>✨ CFG-Guided</strong><br>
+            <small>Better text adherence</small>
+        </div>
+    </div>
+    """)
+    
+    with gr.Row():
+        with gr.Column(scale=1):
+            style_image_input = gr.Image(
+                label="📷 Style Image",
+                type="pil",
+                height=200
+            )
+            
+            style_text_input = gr.Textbox(
+                label="📝 Style Text (Optional)",
+                placeholder="Transcription of text in the style image. Leave empty if unknown - Eruku works without it!",
+                lines=2
+            )
+            
+            gen_text_input = gr.Textbox(
+                label="✍️ Text to Generate",
+                placeholder="Enter the text you want to generate in the selected style",
+                lines=3,
+                value="Hello, World!"
+            )
+            
+            generate_btn = gr.Button("🚀 Generate", variant="primary", size="lg")
+        
+        with gr.Column(scale=1):
+            output_image = gr.Image(
+                label="🎨 Generated Output",
+                type="pil",
+                height=200
+            )
+            
+            status_text = gr.Textbox(
+                label="Status",
+                lines=1,
+                interactive=False
+            )
+    
+    # Examples
+    examples = load_examples()
+    if examples:
+        gr.Examples(
+            examples=examples,
+            inputs=[style_image_input, style_text_input, gen_text_input],
+            label="📚 Example Styles (IAM Dataset - Line Level)",
+            examples_per_page=4
+        )
+    
+    # Connect events
+    generate_btn.click(
+        fn=generate_handwriting,
+        inputs=[style_image_input, style_text_input, gen_text_input],
+        outputs=[output_image, status_text]
+    )
+    
+    gen_text_input.submit(
+        fn=generate_handwriting,
+        inputs=[style_image_input, style_text_input, gen_text_input],
+        outputs=[output_image, status_text]
+    )
+    
+    # How to use section
+    gr.Markdown("""
+    ---
+    ### 📖 How to Use
+    
+    1. **Upload a style image**: A handwritten text sample whose writing style you want to replicate
+    2. **Style text (optional)**: The transcription of the style image. Unlike previous methods, **Eruku works without it!**
+    3. **Enter generation text**: The text you want to render in the extracted style
+    4. **Click Generate**: Eruku will produce text in the style of your reference image
+    
+    ---
+    ### 📚 Citation
+    
+    If you use Eruku in your research, please cite:
+    
+    ```bibtex
+    @inproceedings{zaccagnino2026eruku,
+        title={{Autoregressive Styled Text Image Generation, but Make it Reliable}},
+        author={Zaccagnino, Carmine and Quattrini, Fabio and Pippi, Vittorio 
+                and Cascianelli, Silvia and Tonioni, Alessio and Cucchiara, Rita},
+        booktitle={Proceedings of the IEEE/CVF Winter Conference on 
+                   Applications of Computer Vision (WACV)},
+        year={2026}
+    }
+    
+    @InProceedings{pippi2025zeroshot,
+        author    = {Pippi, Vittorio and Quattrini, Fabio and Cascianelli, Silvia 
+                     and Tonioni, Alessio and Cucchiara, Rita},
+        title     = {Zero-Shot Styled Text Image Generation, but Make It Autoregressive},
+        booktitle = {Proceedings of the IEEE/CVF Conference on Computer Vision 
+                     and Pattern Recognition (CVPR)},
+        year      = {2025},
+        pages     = {7910-7919}
+    }
+    ```
+    
+    ---
+    <p style="text-align: center; color: #888;">
+        Built by <a href="https://aimagelab.ing.unimore.it/" target="_blank">AImageLab</a> @ University of Modena and Reggio Emilia
+    </p>
+    """)
+
 
 if __name__ == "__main__":
     demo.launch()

examples/samples.json

@@ -1,23 +1,22 @@
 [
     {
-        "style_image": "examples/handwritten_1.png",
+        "style_image": "examples/style_1.png",
         "style_text": "",
         "gen_text": "The quick brown fox jumps over the lazy dog"
     },
     {
-        "style_image": "examples/handwritten_2.png",
+        "style_image": "examples/style_2.png",
         "style_text": "",
-        "gen_text": "Hello from the Eruku model!"
+        "gen_text": "Artificial intelligence is transforming the world"
     },
     {
-        "style_image": "examples/handwritten_3.png",
+        "style_image": "examples/style_3.png",
         "style_text": "",
-        "gen_text": "Artificial Intelligence and Machine Learning"
+        "gen_text": "Hello from the Eruku handwriting generation model"
     },
     {
-        "style_image": "examples/typewritten_1.png",
+        "style_image": "examples/style_4.png",
         "style_text": "",
-        "gen_text": "This is typewritten style generation"
+        "gen_text": "Machine learning enables computers to learn from data"
     }
 ]
-