🎬 Generate Interior Moodboards with Claude/Gemini Agents, Hugging Face Image Generation, and PDF Export

⚡ 233 views · 🎬 Content Creation & Video

💡 Pro Tip — HTTP Request scraping tends to break when sites update their markup. If you’re scraping a major platform, check if ScraperNode covers it — it has maintained scrapers for LinkedIn, Instagram, TikTok, YouTube, and 20+ other platforms that return structured data.

View All Scrapers

Description

🎨 Template Overview

This comprehensive n8n workflow automates the complete process of generating professional interior design moodboards from concept to client delivery. Users submit a design brief through a form, and the system automatically generates 12 AI-powered images, compiles them into a beautifully formatted two-page PDF moodboard, and emails the final deliverable.

Screenshot 20251120 091956.png

Key Features:

Technologies Used: Claude Sonnet 4 (OpenRouter), Google Gemini 2.5 Pro, Hugging Face FLUX.1-schnell, Nextcloud, Gotenberg PDF Service, Gmail

⚙️ Self-Hosted Requirements

This template requires the following self-hosted or third-party services:

📋 Setup Instructions

Step 1: Configure API Credentials

  1. OpenRouter (Claude Sonnet 4)

    • Sign up at openrouter.ai
    • Generate an API key
    • Add credentials to the “OpenRouter Chat Model” node

  2. Google Gemini API

    • Visit Google AI Studio
    • Create an API key
    • Add credentials to the “Google Gemini Chat Model1” node

  3. Hugging Face API

    • Register at huggingface.co
    • Generate an access token from Settings → Access Tokens
    • Add credentials to the “Image Generator” node using HTTP Header Auth
    • Header name: Authorization, Value: Bearer YOUR_TOKEN

  4. Nextcloud

    • Set up a Nextcloud instance or use a hosted provider
    • Generate an app password from Settings → Security
    • Configure credentials in all Nextcloud nodes:
      • “Create a folder”
      • “Upload Image”
      • “Share a file”

  5. Gotenberg PDF Service

    • Self-host using Docker: docker run --rm -p 3000:3000 gotenberg/gotenberg:8
    • Or use a hosted instance
    • Update the URL in the “PDF creator” node
    • Configure HTTP Basic Auth credentials if required

  6. Gmail

    • Enable 2-Factor Authentication on your Google account
    • Generate an App Password from Google Account settings
    • Add OAuth2 credentials to the “Send PDF” node

Step 2: Customize Workflow Settings

  1. Email Extractor Node

    • Review the stripPlus variable (default: true)
    • This removes “+tag” portions from email addresses for folder naming

  2. Nextcloud Folder Structure

    • Default path: /moodboard/{username}/
    • Modify in “Create a folder” node if needed

  3. Image Generator Settings

    • Model: FLUX.1-schnell (fast generation, good quality)
    • Adjust model in “Image Generator” node if needed
    • Alternative models: FLUX.1-dev, Stable Diffusion XL

  4. PDF Generation Settings

    • Default timeout: 360 seconds
    • Page size: A4 (210mm × 297mm)
    • Adjust in “PDF creator” node headers if needed

Step 3: Test the Workflow

  1. Activate the Form

    • Open the “Moodboard Form” node
    • Copy the webhook URL
    • Access the form in your browser

  2. Submit a Test Request

    • Fill in the form fields:
      • Title: Short, descriptive name (e.g., “Modern Minimalist Bedroom”)
      • Description: Detailed design brief with colors, materials, mood, lighting
      • Email: Your test email address
    • Submit and monitor workflow execution

  3. Verify Each Stage

    • Check Nextcloud folder creation
    • Monitor image generation progress (12 images)
    • Review HTML moodboard generation
    • Confirm PDF creation
    • Check email delivery

Step 4: Configure Form Embedding (Optional)

Embed the form on your website:

<iframe 
  src="YOUR_N8N_FORM_WEBHOOK_URL" 
  width="100%" 
  height="800" 
  frameborder="0">
</iframe>

🔄 Workflow Structure

1. Form Input & Data Extraction

2. Storage Setup

3. AI Concept Generation

4. Image Processing Loop

5. URL Collection

6. Moodboard Compilation

7. PDF Generation & Delivery

🎯 Node Descriptions

Moodboard Form

Collects moodboard generation requests for any design topic. Users input a title, detailed description (colors, materials, patterns, textures, lighting), and email address for delivery.

Email Extractor

Extracts the username portion from email addresses, optionally stripping “+tags” for clean folder naming and user identification.

Create a Folder

Creates a dedicated Nextcloud folder using the extracted email username, organizing moodboard outputs by user.

Conceptualization Agent

AI agent that analyzes design briefs to generate 12 detailed image prompts (300-500 words each). Performs conceptual analysis of styles, colors, materials, and spatial requirements, outputting structured JSON.

Concept Splitter

Splits the 12 generated image prompts into individual items for parallel processing through the image generation pipeline.

Loop Over Items

Processes each prompt sequentially, generating images, uploading to Nextcloud, and creating public URLs.

Image Generator

Sends detailed prompts to Hugging Face FLUX.1-schnell API for AI-powered image generation, transforming written design concepts into high-quality visuals.

Upload Image

Uploads each generated moodboard image to the user’s Nextcloud folder with appropriate naming conventions.

Share a File

Creates publicly shareable Nextcloud links for each uploaded image, enabling external viewing without authentication.

Set Image Title and URL

Formats image metadata (title and URL) for downstream aggregation.

URL Aggregate

Combines all 12 image URLs into a single consolidated output for moodboard compilation.

Clean URLs

Extracts and formats URLs from the aggregated data into a clean, structured list with count.

Moodboard Generator Agent

Transforms design concepts into professional two-page HTML moodboards. Analyzes project details and 12 image URLs, selecting appropriate visual styles. Creates artistic Page 1 with Image #12 as hero element, and comprehensive Page 2 with design documentation.

Binary Converter

Prepares HTML for PDF conversion by transforming it into binary format with proper encoding and filename (“index.html”) for Gotenberg compatibility.

PDF Creator

Converts HTML moodboard into print-ready PDF with proper A4 dimensions, page breaks, and high-quality image resolution.

Send PDF

Emails the finalized PDF moodboard to the user’s submitted email address with project details and PDF attachment.

🎨 Customization Options

Design Styles

The Moodboard Generator Agent automatically selects from 10 layout styles:

  1. Modern Sectional Grid
  2. Material Board Collage
  3. Editorial Magazine
  4. Clean Minimalist
  5. Split-Screen Dramatic
  6. Asymmetric Feature
  7. Centered Showcase
  8. Modular Block System
  9. Organic Flow
  10. Layered Depth

Image Generation Models

Replace FLUX.1-schnell with alternatives in the “Image Generator” node:

Email Templates

Customize the email message in the “Send PDF” node to include:

🐛 Troubleshooting

Images Not Generating

PDF Generation Fails

Nextcloud Upload Errors

Email Not Received

📊 Performance Notes

🔐 Security Considerations

📝 License & Attribution

This template is provided as-is for the n8n community. Feel free to modify and adapt to your needs.

AI Models Used:

🤝 Support & Contributions

For questions or improvements, please reach out through the n8n community forum or submit issues/PRs to enhance this template.

Created by: Jameson Kanakulya
Template Version: 1.0
Last Updated: November 2025

🔗 Nodes Used

HTTP Request, Nextcloud, Gmail, AI Agent, Simple Memory, Structured Output Parser

📥 Import

Download workflow.json and import into n8n: Workflow menu → Import from File

📖 Importing guide · 🔑 Credential setup