Duplicate from jbilcke-hf/ai-comic-factory

Co-authored-by: Julian Bilcke <[email protected]>

.env

@@ -0,0 +1,40 @@
+# ------------- IMAGE API CONFIG --------------
+# Supported values:
+# - VIDEOCHAIN
+# - REPLICATE
+RENDERING_ENGINE="REPLICATE"
+
+VIDEOCHAIN_API_URL="http://localhost:7860"
+VIDEOCHAIN_API_TOKEN=
+
+REPLICATE_API_TOKEN=
+REPLICATE_API_MODEL="stabilityai/sdxl"
+REPLICATE_API_MODEL_VERSION="da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf"
+
+# ------------- LLM API CONFIG ----------------
+# Supported values:
+# - INFERENCE_ENDPOINT
+# - INFERENCE_API
+LLM_ENGINE="INFERENCE_ENDPOINT"
+
+# Hugging Face token (if you choose to use a custom Inference Endpoint or an Inference API model)
+HF_API_TOKEN=
+
+# URL to a custom text-generation Inference Endpoint of your choice
+# -> You can leave it empty if you decide to use an Inference API Model instead
+HF_INFERENCE_ENDPOINT_URL=
+
+# You can also use a model from the Inference API (not a custom inference endpoint)
+# -> You can leave it empty if you decide to use an Inference Endpoint URL instead
+HF_INFERENCE_API_MODEL="codellama/CodeLlama-7b-hf"
+
+# Not supported yet
+OPENAI_TOKEN=
+
+# ----------- COMMUNITY SHARING (OPTIONAL) -----------
+NEXT_PUBLIC_ENABLE_COMMUNITY_SHARING="false"
+# You don't need those community sharing options to run the AI Comic Factory
+# locally or on your own server (they are meant to be used by the Hugging Face team)
+COMMUNITY_API_URL=
+COMMUNITY_API_TOKEN=
+COMMUNITY_API_ID=

.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "next/core-web-vitals"
+}

.gitignore

@@ -0,0 +1,35 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

.nvmrc

@@ -0,0 +1 @@
+v18.16.0

Dockerfile

@@ -0,0 +1,65 @@
+FROM node:18-alpine AS base
+
+# Install dependencies only when needed
+FROM base AS deps
+# Check https://github.com/nodejs/docker-node/tree/b4117f9333da4138b03a546ec926ef50a31506c3#nodealpine to understand why libc6-compat might be needed.
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
+
+# Install dependencies based on the preferred package manager
+COPY package.json yarn.lock* package-lock.json* pnpm-lock.yaml* ./
+RUN \
+  if [ -f yarn.lock ]; then yarn --frozen-lockfile; \
+  elif [ -f package-lock.json ]; then npm ci; \
+  elif [ -f pnpm-lock.yaml ]; then yarn global add pnpm && pnpm i --frozen-lockfile; \
+  else echo "Lockfile not found." && exit 1; \
+  fi
+
+# Uncomment the following lines if you want to use a secret at buildtime, 
+# for example to access your private npm packages
+# RUN --mount=type=secret,id=HF_EXAMPLE_SECRET,mode=0444,required=true \
+#     $(cat /run/secrets/HF_EXAMPLE_SECRET)
+
+# Rebuild the source code only when needed
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+
+# Next.js collects completely anonymous telemetry data about general usage.
+# Learn more here: https://nextjs.org/telemetry
+# Uncomment the following line in case you want to disable telemetry during the build.
+# ENV NEXT_TELEMETRY_DISABLED 1
+
+# RUN yarn build
+
+# If you use yarn, comment out this line and use the line above
+RUN npm run build
+
+# Production image, copy all the files and run next
+FROM base AS runner
+WORKDIR /app
+
+ENV NODE_ENV production
+# Uncomment the following line in case you want to disable telemetry during runtime.
+# ENV NEXT_TELEMETRY_DISABLED 1
+
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 nextjs
+
+COPY --from=builder /app/public ./public
+
+# Automatically leverage output traces to reduce image size
+# https://nextjs.org/docs/advanced-features/output-file-tracing
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+COPY --from=builder --chown=nextjs:nodejs /app/.next/cache ./.next/cache
+# COPY --from=builder --chown=nextjs:nodejs /app/.next/cache/fetch-cache ./.next/cache/fetch-cache
+
+USER nextjs
+
+EXPOSE 3000
+
+ENV PORT 3000
+
+CMD ["node", "server.js"]

README.md

@@ -0,0 +1,128 @@
+---
+title: AI Comic Factory
+emoji: 👩‍🎨
+colorFrom: red
+colorTo: yellow
+sdk: docker
+app_port: 3000
+duplicated_from: jbilcke-hf/ai-comic-factory
+---
+
+# AI Comic Factory
+
+## Running the project at home
+
+First, I would like to highlight that everything is open-source (see [here](https://huggingface.co/spaces/jbilcke-hf/ai-comic-factory/tree/main), [here](https://huggingface.co/spaces/jbilcke-hf/VideoChain-API/tree/main), [here](https://huggingface.co/spaces/hysts/SD-XL/tree/main), [here](https://github.com/huggingface/text-generation-inference)).
+
+However the project isn't a monolithic Space that can be duplicated and ran immediately:
+it requires various components to run for the frontend, backend, LLM, SDXL etc.
+
+If you try to duplicate the project and open the `.env` you will see it requires some variables:
+
+- `LLM_ENGINE`: can be either "INFERENCE_API" or "INFERENCE_ENDPOINT"
+- `HF_API_TOKEN`: necessary if you decide to use an inference api model or a custom inference endpoint
+- `HF_INFERENCE_ENDPOINT_URL`: necessary if you decide to use a custom inference endpoint
+- `RENDERING_ENGINE`: can only be "VIDEOCHAIN" or "REPLICATE" for now, unless you code your custom solution
+- `VIDEOCHAIN_API_URL`: url to the VideoChain API server
+- `VIDEOCHAIN_API_TOKEN`: secret token to access the VideoChain API server
+- `REPLICATE_API_TOKEN`: in case you want to use Replicate.com
+- `REPLICATE_API_MODEL`: optional, defaults to "stabilityai/sdxl"
+- `REPLICATE_API_MODEL_VERSION`: optional, in case you want to change the version
+
+In addition, there are some community sharing variables that you can just ignore.
+Those variables are not required to run the AI Comic Factory on your own website or computer
+(they are meant to create a connection with the Hugging Face community,
+and thus only make sense for official Hugging Face apps):
+- `NEXT_PUBLIC_ENABLE_COMMUNITY_SHARING`: you don't need this
+- `COMMUNITY_API_URL`: you don't need this
+- `COMMUNITY_API_TOKEN`: you don't need this
+- `COMMUNITY_API_ID`: you don't need this
+
+Please read the `.env` default config file for more informations.
+To customise a variable locally, you should create a `.env.local`
+(do not commit this file as it will contain your secrets).
+
+-> If you intend to run it with local, cloud-hosted and/or proprietary models **you are going to need to code 👨‍💻**.
+
+## The LLM API (Large Language Model)
+
+Currently the AI Comic Factory uses [Llama-2 70b](https://huggingface.co/blog/llama2) through an [Inference Endpoint](https://huggingface.co/docs/inference-endpoints/index).
+
+You have three options:
+
+### Option 1: Use an Inference API model
+
+This is a new option added recently, where you can use one of the models from the Hugging Face Hub. By default we suggest to use CodeLlama 34b as it will provide better results than the 7b model.
+
+To activate it, create a `.env.local` configuration file:
+
+```bash
+LLM_ENGINE="INFERENCE_API"
+
+HF_API_TOKEN="Your Hugging Face token"
+
+# codellama/CodeLlama-7b-hf" is used by default, but you can change this
+# note: You should use a model able to generate JSON responses,
+# so it is storngly suggested to use at least the 34b model
+HF_INFERENCE_API_MODEL="codellama/CodeLlama-7b-hf"
+```
+
+### Option 2: Use an Inference Endpoint URL
+
+If you would like to run the AI Comic Factory on a private LLM running on the Hugging Face Inference Endpoint service, create a `.env.local` configuration file:
+
+```bash
+LLM_ENGINE="INFERENCE_ENDPOINT"
+
+HF_API_TOKEN="Your Hugging Face token"
+
+HF_INFERENCE_ENDPOINT_URL="path to your inference endpoint url"
+```
+
+To run this kind of LLM locally, you can use [TGI](https://github.com/huggingface/text-generation-inference) (Please read [this post](https://github.com/huggingface/text-generation-inference/issues/726) for more information about the licensing).
+
+### Option 3: Fork and modify the code to use a different LLM system
+
+Another option could be to disable the LLM completely and replace it with another LLM protocol and/or provider (eg. OpenAI, Replicate), or a human-generated story instead (by returning mock or static data).
+
+
+### Notes
+
+It is possible that I modify the AI Comic Factory to make it easier in the future (eg. add support for OpenAI or Replicate)
+
+## The Rendering API
+
+This API is used to generate the panel images. This is an API I created for my various projects at Hugging Face.
+
+I haven't written documentation for it yet, but basically it is "just a wrapper ™" around other existing APIs:
+
+- The [hysts/SD-XL](https://huggingface.co/spaces/hysts/SD-XL?duplicate=true) Space by [@hysts](https://huggingface.co/hysts)
+- And other APIs for making videos, adding audio etc.. but you won't need them for the AI Comic Factory
+
+### Option 1: Deploy VideoChain yourself
+
+You will have to [clone](https://huggingface.co/spaces/jbilcke-hf/VideoChain-API?duplicate=true) the [source-code](https://huggingface.co/spaces/jbilcke-hf/VideoChain-API/tree/main)
+
+Unfortunately, I haven't had the time to write the documentation for VideoChain yet.
+(When I do I will update this document to point to the VideoChain's README)
+
+
+### Option 2: Use Replicate
+
+To use Replicate, create a `.env.local` configuration file:
+
+```bash
+RENDERING_ENGINE="REPLICATE"
+
+REPLICATE_API_TOKEN="Your Replicate token"
+
+REPLICATE_API_MODEL="stabilityai/sdxl"
+
+REPLICATE_API_MODEL_VERSION="da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf"
+```
+
+### Option 3: Use another SDXL API
+
+If you fork the project you will be able to modify the code to use the Stable Diffusion technology of your choice (local, open-source, proprietary, your custom HF Space etc).
+
+It would even be something else, such as Dall-E.

components.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "default",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.js",
+    "css": "app/globals.css",
+    "baseColor": "stone",
+    "cssVariables": false
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils"
+  }
+}

next.config.js

@@ -0,0 +1,11 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: 'standalone',
+  
+  experimental: {
+    serverActions: true,
+    serverActionsBodySizeLimit: '8mb',
+  },
+}
+
+module.exports = nextConfig

package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@jbilcke/comic-factory",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@huggingface/inference": "^2.6.1",
+    "@radix-ui/react-accordion": "^1.1.2",
+    "@radix-ui/react-avatar": "^1.0.3",
+    "@radix-ui/react-checkbox": "^1.0.4",
+    "@radix-ui/react-collapsible": "^1.0.3",
+    "@radix-ui/react-dialog": "^1.0.4",
+    "@radix-ui/react-dropdown-menu": "^2.0.5",
+    "@radix-ui/react-icons": "^1.3.0",
+    "@radix-ui/react-label": "^2.0.2",
+    "@radix-ui/react-menubar": "^1.0.3",
+    "@radix-ui/react-popover": "^1.0.6",
+    "@radix-ui/react-select": "^1.2.2",
+    "@radix-ui/react-separator": "^1.0.3",
+    "@radix-ui/react-slider": "^1.1.2",
+    "@radix-ui/react-slot": "^1.0.2",
+    "@radix-ui/react-switch": "^1.0.3",
+    "@radix-ui/react-toast": "^1.1.4",
+    "@radix-ui/react-tooltip": "^1.0.6",
+    "@react-pdf/renderer": "^3.1.12",
+    "@types/node": "20.4.2",
+    "@types/react": "18.2.15",
+    "@types/react-dom": "18.2.7",
+    "@types/uuid": "^9.0.2",
+    "autoprefixer": "10.4.14",
+    "class-variance-authority": "^0.6.1",
+    "clsx": "^2.0.0",
+    "cmdk": "^0.2.0",
+    "cookies-next": "^2.1.2",
+    "date-fns": "^2.30.0",
+    "eslint": "8.45.0",
+    "eslint-config-next": "13.4.10",
+    "html2canvas": "^1.4.1",
+    "lucide-react": "^0.260.0",
+    "next": "13.4.10",
+    "pick": "^0.0.1",
+    "postcss": "8.4.26",
+    "react": "18.2.0",
+    "react-circular-progressbar": "^2.1.0",
+    "react-dom": "18.2.0",
+    "react-virtualized-auto-sizer": "^1.0.20",
+    "replicate": "^0.17.0",
+    "sbd": "^1.0.19",
+    "sharp": "^0.32.5",
+    "styled-components": "^6.0.7",
+    "tailwind-merge": "^1.13.2",
+    "tailwindcss": "3.3.3",
+    "tailwindcss-animate": "^1.0.6",
+    "tesseract.js": "^4.1.2",
+    "ts-node": "^10.9.1",
+    "typescript": "5.1.6",
+    "usehooks-ts": "^2.9.1",
+    "uuid": "^9.0.0",
+    "zustand": "^4.4.1"
+  },
+  "devDependencies": {
+    "@types/qs": "^6.9.7",
+    "@types/react-virtualized": "^9.21.22",
+    "@types/sbd": "^1.0.3"
+  }
+}

postcss.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}

public/favicon/index.html

@@ -0,0 +1,133 @@
+<!DOCTYPE html>
+<head>
+    <title>
+        Favicons
+    </title>
+    <meta charset="utf-8" />
+    
+    <!-- For old IEs -->
+    <link rel="shortcut icon" href="favicon.ico" />
+    
+    <!-- For new browsers multisize ico  -->
+    <link rel="icon" type="image/x-icon" sizes="16x16 32x32" href="favicon.ico">
+        
+        <!-- Chrome for Android -->
+        <link rel="icon" sizes="192x192" href="favicon-192.png">
+            
+            <!-- For iPhone 6+ downscaled for other devices -->
+            <link rel="apple-touch-icon" sizes="180x180" href="favicon-180-precomposed.png">
+                
+                <!-- For IE10 Metro -->
+                <meta name="msapplication-TileColor" content="#FFFFFF">
+                    <meta name="msapplication-TileImage" content="favicon-114-precomposed.png">
+                        
+                        <style>
+                            
+                            body {
+                                background-color: #f5f5f5;
+                                border: 0px;
+                                margin: 0px;
+                                padding: 0px;
+                                font-family: Consolas,Menlo,Monaco,Lucida Console,Liberation Mono,DejaVu Sans Mono,Bitstream Vera Sans Mono,Courier New,monospace,serif;
+                                color: black;
+                            }
+                        
+                        pre {
+                            margin: 0px;
+                            color: black;
+                            padding: 0px 5%;
+                        }
+                        
+                        code {
+                            
+                        }
+                        
+                        .container {
+                            background-color: white;
+                            max-width: 800px;
+                            width: 100%;
+                            margin: 0 auto;
+                            padding: 1% 0;
+                            height: 100%;
+                        }
+                        
+                        .comment {
+                            color: gray;
+                            padding: 0px;
+                            margin: 0px;
+                        }
+                        
+                        hr {
+                            width: 80%;
+                            padding: 0 5%;
+                            border-color: #f5f5f5;
+                            background-color: #D1D1D1;
+                        }
+                        
+                        p {
+                            padding: 1% 5%;
+                        }
+                        
+                            </style>
+                        
+                        </head>
+<body class="">
+    
+    <div class="container">
+        <p>
+        To use the favicons insert into your  head section some of these tags accordly to your needs.
+        </p>
+        <hr>
+        <pre>
+            <code>
+                <span class="comment">&lt;!-- For old IEs --&gt;</span>
+                &lt;link rel=&quot;shortcut icon&quot; href=&quot;favicon.ico&quot; /&gt;
+                
+                <span class="comment">&lt;!-- For new browsers - multisize ico  --&gt;</span>
+                &lt;link rel=&quot;icon&quot; type=&quot;image/x-icon&quot; sizes=&quot;16x16 32x32&quot; href=&quot;favicon.ico&quot;&gt;
+                
+                <span class="comment">&lt;!-- For iPad with high-resolution Retina display running iOS &ge; 7: --&gt;</span>
+                &lt;link rel=&quot;apple-touch-icon&quot; sizes=&quot;152x152&quot; href=&quot;favicon-152-precomposed.png&quot;&gt;
+                
+                <span class="comment">&lt;!-- For iPad with high-resolution Retina display running iOS &le; 6: --&gt;</span>
+                &lt;link rel=&quot;apple-touch-icon&quot; sizes=&quot;144x144&quot; href=&quot;favicon-144-precomposed.png&quot;&gt;
+                
+                <span class="comment">&lt;!-- For iPhone with high-resolution Retina display running iOS &ge; 7: --&gt;</span>
+                &lt;link rel=&quot;apple-touch-icon&quot; sizes=&quot;120x120&quot; href=&quot;favicon-120-precomposed.png&quot;&gt;
+                
+                <span class="comment">&lt;!-- For iPhone with high-resolution Retina display running iOS &le; 6: --&gt;</span>
+                &lt;link rel=&quot;apple-touch-icon&quot; sizes=&quot;114x114&quot; href=&quot;favicon-114-precomposed.png&quot;&gt;
+                
+                <span class="comment">&lt;!-- For iPhone 6+ --&gt;</span>
+                &lt;link rel=&quot;apple-touch-icon&quot; sizes=&quot;180x180&quot; href=&quot;favicon-180-precomposed.png&quot;&gt;
+                
+                <span class="comment">&lt;!-- For first- and second-generation iPad: --&gt;</span>
+                &lt;link rel=&quot;apple-touch-icon&quot; sizes=&quot;72x72&quot; href=&quot;favicon-72-precomposed.png&quot;&gt;
+                
+                <span class="comment">&lt;!-- For non-Retina iPhone, iPod Touch, and Android 2.1+ devices: --&gt;</span>
+                &lt;link rel=&quot;apple-touch-icon&quot; sizes=&quot;57x57&quot; href=&quot;favicon-57.png&quot;&gt;
+                
+                <span class="comment">&lt;!-- For Old Chrome --&gt;</span>
+                &lt;link rel=&quot;icon&quot; sizes=&quot;32x32&quot; href=&quot;favicon-32.png&quot; &gt;
+                
+                <span class="comment">&lt;!-- For IE10 Metro --&gt;</span>
+                &lt;meta name=&quot;msapplication-TileColor&quot; content=&quot;#FFFFFF&quot;&gt;
+                &lt;meta name=&quot;msapplication-TileImage&quot; content=&quot;favicon-144.png&quot;&gt;
+                &lt;meta name=&quot;theme-color&quot; content=&quot;#ffffff&quot;&gt;
+                
+                <span class="comment">&lt;!-- Chrome for Android --&gt;</span>
+                &lt;link rel=&quot;manifest&quot; href=&quot;manifest.json&quot;&gt;
+                &lt;link rel=&quot;icon&quot; sizes=&quot;192x192&quot; href=&quot;favicon-192.png&quot;&gt;
+                
+            </code>
+        </pre>
+        
+        <hr>
+        
+        <p>
+        For more informations about favicons consult <a href="https://github.com/audreyr/favicon-cheat-sheet">The Favicon Cheat Sheet</a> by Audrey Roy.
+        </p>
+        
+    </div>
+    
+</body>

public/favicon/manifest.json

@@ -0,0 +1,41 @@
+{
+	"name": "pollo",
+	"icons": [
+		{
+			"src": "\/favicon-36.png",
+			"sizes": "36x36",
+			"type": "image\/png",
+			"density": 0.75
+		},
+		{
+			"src": "\/favicon-48.png",
+			"sizes": "48x48",
+			"type": "image\/png",
+			"density": 1
+		},
+		{
+			"src": "\/favicon-72.png",
+			"sizes": "72x72",
+			"type": "image\/png",
+			"density": 1.5
+		},
+		{
+			"src": "\/favicon-96.png",
+			"sizes": "96x96",
+			"type": "image\/png",
+			"density": 2
+		},
+		{
+			"src": "\/favicon-144.png",
+			"sizes": "144x144",
+			"type": "image\/png",
+			"density": 3
+		},
+		{
+			"src": "\/favicon-192.png",
+			"sizes": "192x192",
+			"type": "image\/png",
+			"density": 4
+		}
+	]
+}

src/app/engine/caption.ts

@@ -0,0 +1,54 @@
+"use server"
+
+import { ImageAnalysisRequest, ImageAnalysisResponse } from "@/types"
+
+const apiUrl = `${process.env.VIDEOCHAIN_API_URL || ""}`
+
+export async function see({
+  prompt,
+  imageBase64
+}: {
+  prompt: string
+  imageBase64: string
+}): Promise<string> {
+  if (!prompt) {
+    console.error(`cannot call the API without an image, aborting..`)
+    throw new Error(`cannot call the API without an image, aborting..`)
+  }
+
+  try {
+    const request = {
+      prompt,
+      image: imageBase64
+
+    } as ImageAnalysisRequest
+
+    console.log(`calling ${apiUrl}/analyze called with: `, {
+      prompt: request.prompt,
+      image: request.image.slice(0, 20)
+    })
+
+    const res = await fetch(`${apiUrl}/analyze`, {
+      method: "POST",
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        // Authorization: `Bearer ${process.env.VIDEOCHAIN_API_TOKEN}`,
+      },
+      body: JSON.stringify(request),
+      cache: 'no-store',
+    // we can also use this (see https://vercel.com/blog/vercel-cache-api-nextjs-cache)
+    // next: { revalidate: 1 }
+    })
+
+    if (res.status !== 200) {
+      throw new Error('Failed to fetch data')
+    }
+
+    const response = (await res.json()) as ImageAnalysisResponse
+    return response.result
+  } catch (err) {
+    console.error(err)
+    return ""
+  }
+}

src/app/engine/censorship.ts

@@ -0,0 +1,39 @@
+
+
+// unfortunately due to abuse by some users, I have to add this NSFW filter
+const secretSalt = `${process.env.SECRET_CENSORSHIP_KEY || ""}`
+
+// TODO the censorship is not implement yet actually
+
+// I don't want to be banned by Replicate because bad actors are asking
+// for some naked anime stuff or whatever
+// I also want to avoid a PR scandal due to some bad user generated content
+
+const forbiddenWords = [
+  // those keywords have been generated by looking at the logs of the AI Comic Factory
+  // those are real requests some users tried to attempt.. :|
+  "nazi",
+  "hitler",
+  "boob",
+  "boobs",
+  "boobies",
+  "nipple",
+  "nipples",
+  "nude",
+  "nudes",
+  "naked",
+  "pee",
+  "peeing",
+  "erotic",
+  "sexy"
+]
+
+// temporary utility to make sure Replicate doesn't ban my account 
+// because of what users do in their prompt
+export const filterOutBadWords = (sentence: string) => {
+  const words = sentence.split(" ")
+  return words.filter(word => {
+    const lowerCase = word.toLocaleLowerCase()
+    return !forbiddenWords.includes(lowerCase)
+  }).join(" ")
+}

src/app/engine/community.ts

@@ -0,0 +1,135 @@
+"use server"
+
+import { v4 as uuidv4 } from "uuid"
+
+import { CreatePostResponse, GetAppPostsResponse, Post, PostVisibility } from "@/types"
+import { filterOutBadWords } from "./censorship"
+
+const apiUrl = `${process.env.COMMUNITY_API_URL || ""}`
+const apiToken = `${process.env.COMMUNITY_API_TOKEN || ""}`
+const appId = `${process.env.COMMUNITY_API_ID || ""}`
+
+export async function postToCommunity({
+  prompt,
+  assetUrl,
+}: {
+  prompt: string
+  assetUrl: string
+}): Promise<Post> {
+
+  prompt = filterOutBadWords(prompt)
+
+  // if the community API is disabled,
+  // we don't fail, we just mock
+  if (!apiUrl) {
+    const mockPost: Post = {
+      postId: uuidv4(),
+      appId: "mock",
+      prompt,
+      previewUrl: assetUrl,
+      assetUrl,
+      createdAt: new Date().toISOString(),
+      visibility: "normal",
+      upvotes: 0,
+      downvotes: 0
+    }
+    return mockPost
+  }
+
+  if (!prompt) {
+    console.error(`cannot call the community API without a prompt, aborting..`)
+    throw new Error(`cannot call the community API without a prompt, aborting..`)
+  }
+  if (!assetUrl) {
+    console.error(`cannot call the community API without an assetUrl, aborting..`)
+    throw new Error(`cannot call the community API without an assetUrl, aborting..`)
+  }
+
+  try {
+    console.log(`calling POST ${apiUrl}/posts/${appId} with prompt: ${prompt}`)
+
+    const postId = uuidv4()
+
+    const post: Partial<Post> = { postId, appId, prompt, assetUrl }
+
+    console.table(post)
+
+    const res = await fetch(`${apiUrl}/posts/${appId}`, {
+      method: "POST",
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiToken}`,
+      },
+      body: JSON.stringify(post),
+      cache: 'no-store',
+    // we can also use this (see https://vercel.com/blog/vercel-cache-api-nextjs-cache)
+    // next: { revalidate: 1 }
+    })
+
+    // console.log("res:", res)
+    // The return value is *not* serialized
+    // You can return Date, Map, Set, etc.
+    
+    // Recommendation: handle errors
+    if (res.status !== 200) {
+      // This will activate the closest `error.js` Error Boundary
+      throw new Error('Failed to fetch data')
+    }
+    
+    const response = (await res.json()) as CreatePostResponse
+    // console.log("response:", response)
+    return response.post
+  } catch (err) {
+    const error = `failed to post to community: ${err}`
+    console.error(error)
+    throw new Error(error)
+  }
+}
+
+export async function getLatestPosts(visibility?: PostVisibility): Promise<Post[]> {
+
+  let posts: Post[] = []
+
+  // if the community API is disabled we don't fail,
+  // we just mock
+  if (!apiUrl) {
+    return posts
+  }
+
+  try {
+    // console.log(`calling GET ${apiUrl}/posts with renderId: ${renderId}`)
+    const res = await fetch(`${apiUrl}/posts/${appId}/${
+      visibility || "all"
+    }`, {
+      method: "GET",
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiToken}`,
+      },
+      cache: 'no-store',
+    // we can also use this (see https://vercel.com/blog/vercel-cache-api-nextjs-cache)
+    // next: { revalidate: 1 }
+    })
+
+    // console.log("res:", res)
+    // The return value is *not* serialized
+    // You can return Date, Map, Set, etc.
+    
+    // Recommendation: handle errors
+    if (res.status !== 200) {
+      // This will activate the closest `error.js` Error Boundary
+      throw new Error('Failed to fetch data')
+    }
+    
+    const response = (await res.json()) as GetAppPostsResponse
+    // console.log("response:", response)
+    return Array.isArray(response?.posts) ? response?.posts : []
+  } catch (err) {
+    // const error = `failed to get posts: ${err}`
+    // console.error(error)
+    // throw new Error(error)
+    return []
+  }
+}

src/app/engine/forbidden.ts

@@ -0,0 +1,6 @@
+
+// the NSFW has to contain bad words, but doing so might get the code flagged
+// or attract unwanted attention, so we hash them
+export const forbidden = [
+  // TODO implement this
+]

src/app/engine/presets.ts

@@ -0,0 +1,559 @@
+import { FontName, actionman, komika, vtc } from "@/lib/fonts"
+import { pick } from "@/lib/pick"
+import { NextFontWithVariable } from "next/dist/compiled/@next/font"
+
+export type ComicFamily =
+  | "american"
+  | "asian"
+  | "european"
+
+export type ComicColor =
+  | "color"
+  | "grayscale"
+  | "monochrome"
+
+export interface Preset {
+  id: string
+  label: string
+  family: ComicFamily
+  color: ComicColor
+  font: FontName
+  llmPrompt: string
+  imagePrompt: (prompt: string) => string[]
+  negativePrompt: (prompt: string) => string[]
+}
+
+// ATTENTION!! negative prompts are not supported by the VideoChain API yet
+
+export const presets: Record<string, Preset> = {
+  random: {
+    id: "random",
+    label: "Random style",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "",
+    imagePrompt: (prompt: string) => [],
+    negativePrompt: () => [],
+  },
+  japanese_manga: {
+    id: "japanese_manga",
+    label: "Japanese",
+    family: "asian",
+    color: "grayscale",
+    font: "actionman",
+    llmPrompt: "japanese manga",
+    imagePrompt: (prompt: string) => [
+      `japanese manga about ${prompt}`,
+      "single panel",
+      "manga",
+      "japanese",
+      "grayscale",
+      "intricate",
+      "detailed",
+      // "drawing"
+    ],
+    negativePrompt: () => [
+      "franco-belgian comic",
+      "color album",
+      "color",
+      "american comic",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+  nihonga: {
+    id: "nihonga",
+    label: "Nihonga",
+    family: "asian",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "japanese manga",
+    imagePrompt: (prompt: string) => [
+      `japanese nihonga painting about ${prompt}`,
+      "Nihonga",
+      "ancient japanese painting",
+      "intricate",
+      "detailed",
+      // "drawing"
+    ],
+    negativePrompt: () => [
+      "franco-belgian comic",
+      "color album",
+      "color",
+      "manga",
+      "comic",
+      "american comic",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+  franco_belgian: {
+    id: "franco_belgian",
+    label: "Franco-Belgian",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "Franco-Belgian comic (a \"bande dessinée\"), in the style of Franquin, Moebius etc",
+    imagePrompt: (prompt: string) => [
+      `franco-belgian color comic about ${prompt}`,
+      "bande dessinée",
+      "franco-belgian comic",
+      "comic album",
+      // "color drawing"
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+  american_comic_90: {
+    id: "american_comic_90",
+    label: "American (modern)",
+    family: "american",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "american comic",
+    imagePrompt: (prompt: string) => [
+      `modern american comic about ${prompt}`,
+      //"single panel",
+      "digital color comicbook style",
+      // "2010s",
+      // "digital print",
+      // "color comicbook",
+      // "color drawing"
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "action",
+      "grayscale",
+      "monochrome",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+
+  /*
+  american_comic_40: {
+    label: "American (1940)",
+    family: "american",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "american comic",
+    imagePrompt: (prompt: string) => [
+      `american comic about ${prompt}`,
+      "single panel",
+      "american comic",
+      "comicbook style",
+      "1940",
+      "40s",
+      "color comicbook",
+      "color drawing"
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "action",
+      "grayscale",
+      "monochrome",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+  */
+  american_comic_50: {
+    id: "american_comic_50",
+    label: "American (1950)",
+    family: "american",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "american comic",
+    imagePrompt: (prompt: string) => [
+      `vintage american color comic about ${prompt}`,
+      // "single panel",
+     //  "comicbook style",
+      "1950",
+      "50s",
+      // "color comicbook",
+      // "color drawing"
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "action",
+      "grayscale",
+      "monochrome",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+  /*
+  american_comic_60: {
+    label: "American (1960)",
+    family: "american",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "american comic",
+    imagePrompt: (prompt: string) => [
+      `american comic about ${prompt}`,
+      "single panel",
+      "american comic",
+      "comicbook style",
+      "1960",
+      "60s",
+      "color comicbook",
+      "color drawing"
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "action",
+      "grayscale",
+      "monochrome",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+  */
+
+  
+  flying_saucer: {
+    id: "flying_saucer",
+    label: "Flying saucer",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new pulp science fiction",
+    imagePrompt: (prompt: string) => [
+      `vintage color pulp comic panel`,
+      `${prompt}`,
+      "40s",
+      "1940",
+      "vintage science fiction",
+      // "single panel",
+      // "comic album"
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+ 
+  humanoid: {
+    id: "humanoid",
+    label: "Humanoid",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new album by moebius",
+    imagePrompt: (prompt: string) => [
+      `color comic panel`,
+      `${prompt}`,
+      "style of Moebius",
+      "by Moebius",
+      "french comic panel",
+      "franco-belgian style",
+      "bande dessinée",
+      "single panel",
+      // "comic album"
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+  haddock: {
+    id: "haddock",
+    label: "Haddock",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new album by Hergé",
+    imagePrompt: (prompt: string) => [
+      `color comic panel`,
+      `${prompt}`,
+      "style of Hergé",
+      "by Hergé",
+      "tintin style",
+      "french comic panel",
+      "franco-belgian style",
+     //  "color panel",
+     //  "bande dessinée",
+      // "single panel",
+      // "comic album"
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+  armorican: {
+    id: "armorican",
+    label: "Armorican",
+    family: "european",
+    color: "monochrome",
+    font: "actionman",
+    llmPrompt: "new color album",
+    imagePrompt: (prompt: string) => [
+      `color comic panel`,
+      `about ${prompt}`,
+      "romans",
+      "gauls",
+      "french comic panel",
+      "franco-belgian style",
+      "bande dessinée",
+      "single panel",
+      // "comical",
+      // "comic album",
+      // "color drawing"
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "photo",
+      "painting",
+      "3D render"
+    ],
+  },
+  render: {
+    id: "render",
+    label: "3D Render",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new movie",
+    imagePrompt: (prompt: string) => [
+      `3D render`,
+      `Blender`,
+      `3D animation`,
+      `Unreal engine`,
+      `${prompt}`,
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "painting"
+    ],
+  },
+  klimt: {
+    id: "klimt",
+    label: "Klimt",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new story",
+    imagePrompt: (prompt: string) => [
+      `golden`,
+      `patchwork`,
+      `style of Gustav Klimt`,
+      `Gustav Klimt painting`,
+      `${prompt}`,
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "painting"
+    ],
+  },
+  medieval: {
+    id: "medieval",
+    label: "Medieval",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new story",
+    imagePrompt: (prompt: string) => [
+      `medieval illuminated manuscript`,
+      `illuminated manuscript of`,
+      // `medieval color engraving`,
+      `${prompt}`,
+      `medieval`
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "painting"
+    ],
+  },
+  /*
+  glass: {
+    id: "glass",
+    label: "Glass",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new movie",
+    imagePrompt: (prompt: string) => [
+      `stained glass`,
+      `vitrail`,
+      `stained glass`,
+      // `medieval color engraving`,
+      `${prompt}`,
+      `medieval`,
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "painting"
+    ],
+  },
+  */
+  /*
+  voynich: {
+    id: "voynich",
+    label: "Voynich",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new movie",
+    imagePrompt: (prompt: string) => [
+      `voynich`,
+      `voynich page`,
+      // `medieval color engraving`,
+      `${prompt}`,
+      `medieval`,
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "painting"
+    ],
+  },
+  */
+  egyptian: {
+    id: "egyptian",
+    label: "Egyptian",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new movie",
+    imagePrompt: (prompt: string) => [
+      `ancient egyptian wall painting`,
+      // `medieval color engraving`,
+      `${prompt}`,
+      `ancient egypt`,
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "painting"
+    ],
+  },
+  /*
+  psx: {
+    label: "PSX",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new movie",
+    imagePrompt: (prompt: string) => [
+      `videogame screenshot`,
+      `3dfx`,
+      `3D dos game`,
+      `software rendering`,
+      `${prompt}`,
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "painting"
+    ],
+  },
+  */
+ /*
+  pixel: {
+    label: "Pixel",
+    family: "european",
+    color: "color",
+    font: "actionman",
+    llmPrompt: "new movie",
+    imagePrompt: (prompt: string) => [
+      `pixelart`,
+      `isometric`,
+      `pixelated`,
+      `low res`,
+      `${prompt}`,
+    ],
+    negativePrompt: () => [
+      "manga",
+      "anime",
+      "american comic",
+      "grayscale",
+      "monochrome",
+      "painting"
+    ],
+  },
+  */
+}
+
+export type PresetName = keyof typeof presets
+
+export const defaultPreset: PresetName = "american_comic_90"
+
+export const nonRandomPresets = Object.keys(presets).filter(p => p !== "random")
+
+export const getPreset = (preset?: PresetName): Preset => presets[preset || defaultPreset] || presets[defaultPreset]
+
+export const getRandomPreset = (): Preset => {
+  const presetName = pick(Object.keys(presets).filter(preset => preset !== "random")) as PresetName
+  return getPreset(presetName)
+}

src/app/engine/render.ts

@@ -0,0 +1,294 @@
+"use server"
+
+import Replicate, { Prediction } from "replicate"
+
+import { RenderRequest, RenderedScene, RenderingEngine } from "@/types"
+import { generateSeed } from "@/lib/generateSeed"
+import { sleep } from "@/lib/sleep"
+
+const renderingEngine = `${process.env.RENDERING_ENGINE || ""}` as RenderingEngine
+
+const replicateToken = `${process.env.REPLICATE_API_TOKEN || ""}`
+const replicateModel = `${process.env.REPLICATE_API_MODEL || ""}`
+const replicateModelVersion = `${process.env.REPLICATE_API_MODEL_VERSION || ""}`
+
+// note: there is no / at the end in the variable
+// so we have to add it ourselves if needed
+const apiUrl = process.env.VIDEOCHAIN_API_URL
+
+export async function newRender({
+  prompt,
+  // negativePrompt,
+  width,
+  height
+}: {
+  prompt: string
+  // negativePrompt: string[]
+  width: number
+  height: number
+}) {
+  // console.log(`newRender(${prompt})`)
+  if (!prompt) {
+    console.error(`cannot call the rendering API without a prompt, aborting..`)
+    throw new Error(`cannot call the rendering API without a prompt, aborting..`)
+  }
+
+  let defaulResult: RenderedScene = {
+    renderId: "",
+    status: "error",
+    assetUrl: "",
+    alt: prompt || "",
+    maskUrl: "",
+    error: "failed to fetch the data",
+    segments: []
+  }
+
+
+  try {
+    if (renderingEngine === "REPLICATE") {
+      if (!replicateToken) {
+        throw new Error(`you need to configure your REPLICATE_API_TOKEN in order to use the REPLICATE rendering engine`)
+      }
+      if (!replicateModel) {
+        throw new Error(`you need to configure your REPLICATE_API_MODEL in order to use the REPLICATE rendering engine`)
+      }
+      if (!replicateModelVersion) {
+        throw new Error(`you need to configure your REPLICATE_API_MODEL_VERSION in order to use the REPLICATE rendering engine`)
+      }
+      const replicate = new Replicate({ auth: replicateToken })
+
+      // console.log("Calling replicate..")
+      const seed = generateSeed()
+      const prediction = await replicate.predictions.create({
+        version: replicateModelVersion,
+        input: { prompt, seed }
+      })
+      
+      // console.log("prediction:", prediction)
+
+      // no need to reply straight away: good things take time
+      // also our friends at Replicate won't like it if we spam them with requests
+      await sleep(4000)
+
+      return {
+        renderId: prediction.id,
+        status: "pending",
+        assetUrl: "", 
+        alt: prompt,
+        error: prediction.error,
+        maskUrl: "",
+        segments: []
+      } as RenderedScene
+    } else {
+      // console.log(`calling POST ${apiUrl}/render with prompt: ${prompt}`)
+      const res = await fetch(`${apiUrl}/render`, {
+        method: "POST",
+        headers: {
+          Accept: "application/json",
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${process.env.VIDEOCHAIN_API_TOKEN}`,
+        },
+        body: JSON.stringify({
+          prompt,
+          // negativePrompt, unused for now
+          nbFrames: 1,
+          nbSteps: 25, // 20 = fast, 30 = better, 50 = best
+          actionnables: [], // ["text block"],
+          segmentation: "disabled", // "firstframe", // one day we will remove this param, to make it automatic
+          width,
+          height,
+
+          // no need to upscale right now as we generate tiny panels
+          // maybe later we can provide an "export" button to PDF
+          // unfortunately there are too many requests for upscaling,
+          // the server is always down
+          upscalingFactor: 1, // 2,
+
+          // analyzing doesn't work yet, it seems..
+          analyze: false, // analyze: true,
+
+          cache: "ignore"
+        } as Partial<RenderRequest>),
+        cache: 'no-store',
+      // we can also use this (see https://vercel.com/blog/vercel-cache-api-nextjs-cache)
+      // next: { revalidate: 1 }
+      })
+
+
+      // console.log("res:", res)
+      // The return value is *not* serialized
+      // You can return Date, Map, Set, etc.
+      
+      // Recommendation: handle errors
+      if (res.status !== 200) {
+        // This will activate the closest `error.js` Error Boundary
+        throw new Error('Failed to fetch data')
+      }
+      
+      const response = (await res.json()) as RenderedScene
+      return response
+    }
+  } catch (err) {
+    console.error(err)
+    return defaulResult
+  }
+}
+
+export async function getRender(renderId: string) {
+  if (!renderId) {
+    console.error(`cannot call the rendering API without a renderId, aborting..`)
+    throw new Error(`cannot call the rendering API without a renderId, aborting..`)
+  }
+
+  let defaulResult: RenderedScene = {
+    renderId: "",
+    status: "pending",
+    assetUrl: "",
+    alt: "",
+    maskUrl: "",
+    error: "failed to fetch the data",
+    segments: []
+  }
+
+  try {
+    if (renderingEngine === "REPLICATE") {
+      if (!replicateToken) {
+        throw new Error(`you need to configure your REPLICATE_API_TOKEN in order to use the REPLICATE rendering engine`)
+      }
+      if (!replicateModel) {
+        throw new Error(`you need to configure your REPLICATE_API_MODEL in order to use the REPLICATE rendering engine`)
+      }
+
+      // const replicate = new Replicate({ auth: replicateToken })
+
+      // console.log("Calling replicate..")
+      // const prediction = await replicate.predictions.get(renderId)
+      // console.log("Prediction:", prediction)
+
+       // console.log(`calling GET https://api.replicate.com/v1/predictions/${renderId}`)
+       const res = await fetch(`https://api.replicate.com/v1/predictions/${renderId}`, {
+        method: "GET",
+        headers: {
+          // Accept: "application/json",
+          // "Content-Type": "application/json",
+          Authorization: `Token ${replicateToken}`,
+        },
+        cache: 'no-store',
+      // we can also use this (see https://vercel.com/blog/vercel-cache-api-nextjs-cache)
+      // next: { revalidate: 1 }
+      })
+    
+      // console.log("res:", res)
+      // The return value is *not* serialized
+      // You can return Date, Map, Set, etc.
+      
+      // Recommendation: handle errors
+      if (res.status !== 200) {
+        // This will activate the closest `error.js` Error Boundary
+        throw new Error('Failed to fetch data')
+      }
+      
+      const response = (await res.json()) as any
+      // console.log("response:", response)
+
+      return  {
+        renderId,
+        status: response?.error ? "error" : response?.status === "succeeded" ?  "completed" : "pending",
+        assetUrl: `${response?.output || ""}`,
+        alt: `${response?.input?.prompt || ""}`,
+        error: `${response?.error || ""}`,
+        maskUrl: "",
+        segments: []
+      } as RenderedScene
+    } else {
+      // console.log(`calling GET ${apiUrl}/render with renderId: ${renderId}`)
+      const res = await fetch(`${apiUrl}/render/${renderId}`, {
+        method: "GET",
+        headers: {
+          Accept: "application/json",
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${process.env.VIDEOCHAIN_API_TOKEN}`,
+        },
+        cache: 'no-store',
+      // we can also use this (see https://vercel.com/blog/vercel-cache-api-nextjs-cache)
+      // next: { revalidate: 1 }
+      })
+
+      // console.log("res:", res)
+      // The return value is *not* serialized
+      // You can return Date, Map, Set, etc.
+      
+      // Recommendation: handle errors
+      if (res.status !== 200) {
+        // This will activate the closest `error.js` Error Boundary
+        throw new Error('Failed to fetch data')
+      }
+      
+      const response = (await res.json()) as RenderedScene
+      // console.log("response:", response)
+      return response
+    }
+  } catch (err) {
+    console.error(err)
+    defaulResult.status = "error"
+    defaulResult.error = `${err}`
+    // Gorgon.clear(cacheKey)
+    return defaulResult
+  }
+
+  // }, cacheDurationInSec * 1000)
+}
+
+export async function upscaleImage(image: string): Promise<{
+  assetUrl: string
+  error: string
+}> {
+  if (!image) {
+    console.error(`cannot call the rendering API without an image, aborting..`)
+    throw new Error(`cannot call the rendering API without an image, aborting..`)
+  }
+
+  let defaulResult = {
+    assetUrl: "",
+    error: "failed to fetch the data",
+  }
+
+  try {
+    // console.log(`calling GET ${apiUrl}/render with renderId: ${renderId}`)
+    const res = await fetch(`${apiUrl}/upscale`, {
+      method: "POST",
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${process.env.VIDEOCHAIN_API_TOKEN}`,
+      },
+      cache: 'no-store',
+      body: JSON.stringify({ image, factor: 3 })
+    // we can also use this (see https://vercel.com/blog/vercel-cache-api-nextjs-cache)
+    // next: { revalidate: 1 }
+    })
+
+    // console.log("res:", res)
+    // The return value is *not* serialized
+    // You can return Date, Map, Set, etc.
+    
+    // Recommendation: handle errors
+    if (res.status !== 200) {
+      // This will activate the closest `error.js` Error Boundary
+      throw new Error('Failed to fetch data')
+    }
+    
+    const response = (await res.json()) as {
+      assetUrl: string
+      error: string
+    }
+    // console.log("response:", response)
+    return response
+  } catch (err) {
+    console.error(err)
+    // Gorgon.clear(cacheKey)
+    return defaulResult
+  }
+
+  // }, cacheDurationInSec * 1000)
+}