n8n-nodes-agentgen

This is an n8n community node for AgentGen — an HTML → PDF and HTML → Image generation service built for AI agents and developers.

Send an HTML string, get back a publicly accessible URL pointing to a rendered PDF or image.

n8n is a fair-code licensed workflow automation platform.

Demo

Installation (after n8n approval)

Once the package is listed in the n8n community registry, install it directly from the n8n UI:

1. Open n8n → Settings → Community Nodes
2. Click Install a community node
3. Enter n8n-nodes-agentgen and click Install

Manual installation (before approval)

The node can be installed manually on any self-hosted n8n instance right now, without waiting for n8n's approval process. n8n Cloud does not support manual community node installation.

Option A — Install from npm (recommended)

Requires the package to be published to npm first (npm publish from the n8n/ directory).

Step 1 — Locate your n8n data directory

This is the folder n8n uses for custom nodes. Default locations:

| How you run n8n | Default path | |-----------------|--------------| | npm global | ~/.n8n | | Docker | the volume mounted to /home/node/.n8n | | n8n desktop | ~/.n8n |

Step 2 — Install the package

cd ~/.n8n          # or your custom data directory
npm install n8n-nodes-agentgen

Step 3 — Restart n8n

# npm
n8n start

# Docker
docker restart <your-n8n-container>

Step 4 — Verify — Open n8n, add a new node, and search for AgentGen. It should appear under the Community section.

Option B — Install from a local build (no npm publish needed)

Use this during development or to share the node privately.

Step 1 — Build and pack

cd n8n
npm run build
npm pack
# Produces: n8n-nodes-agentgen-0.1.0.tgz

Step 2 — Install the tarball into n8n

cd ~/.n8n          # your n8n data directory
npm install /path/to/n8n-nodes-agentgen-0.1.0.tgz

Step 3 — Restart n8n (same as Option A, Step 3)

Using the node in a workflow

1. Set up your credential

1. In n8n, open Credentials → Add Credential
2. Search for AgentGen API
3. Paste your API key (get one at agent-gen.com)
4. Click Test credential — n8n will call /v1/balance to confirm the key works
5. Save

2. Add the AgentGen node to a workflow

1. Open a workflow (or create a new one)
2. Click the + button to add a node
3. Search for AgentGen — select it
4. In the node panel, pick your Operation from the dropdown

Walkthrough: Generate an image from HTML

1. Add an AgentGen node
2. Set Operation → Generate Image
3. In the HTML field, enter your markup:

   <div style="font-family:sans-serif;padding:40px;background:#6C47FF;color:white;border-radius:12px">
     <h1>Hello from AgentGen 👋</h1>
     <p>Rendered by n8n</p>
   </div>

4. (Optional) expand Image Options to set width, height, or format
5. Select your AgentGen API credential
6. Click Test step — the output will contain a url field with a direct link to the rendered PNG

Walkthrough: Generate a PDF from HTML

1. Add an AgentGen node, set Operation → Generate PDF
2. PDF Mode → Single Page
3. Enter your HTML in the HTML field
4. (Optional) expand PDF Options to set paper size, margins, or landscape mode
5. Run the node — output contains url (the PDF link) and pages (page count)

Multi-page PDF:

1. Set PDF Mode → Multi-Page
2. In the Pages (JSON) field, provide an array:

   [
     { "html": "<h1 style='font-family:sans-serif'>Cover Page</h1>", "format": "A4" },
     { "html": "<p style='font-family:sans-serif'>Page two content</p>", "format": "A4" }
   ]

3. Run — you get a single PDF with one page per array element

Walkthrough: Upload a temp file for use in HTML

Use this when your HTML needs to reference a local image or font.

1. Add an HTTP Request node (or Read Binary File) before AgentGen to load your file into the workflow as binary data
2. Add an AgentGen node, set Operation → Upload Temp File
3. Set Input Binary Field to the name of the binary property from the previous node (usually data)
4. Run the node — the output contains a url valid for 24 hours
5. Use that URL in an <img src="..."> tag in a subsequent Generate Image or Generate PDF node

Walkthrough: Check your token balance

1. Add an AgentGen node, set Operation → Get Balance
2. Run — output: { "tokens": 42 }

Operations

| Operation | Description | Token cost | |-----------|-------------|------------| | Generate Image | Render HTML → PNG / JPEG / WebP screenshot | 1 token | | Generate PDF | Render HTML → PDF (single or multi-page) | 2 tokens / page | | Upload Temp File | Upload an asset for use inside HTML templates | Free | | Get Balance | Check current token balance | Free |

Generate Image

Renders an HTML string to an image file.

| Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | HTML | ✅ | — | HTML content to render (max 500 KB) | | Width | — | 1200 | Viewport width in px (1–5000) | | Height | — | 630 | Viewport height in px (1–5000) | | Format | — | png | Output format: png, jpeg, or webp | | Device Scale Factor | — | 2 | Pixel ratio (1–3). 2 = retina-quality |

Output: { url, width, height, format, tokens_used, request_id }

Generate PDF — Single Page

| Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | HTML | ✅ | — | HTML content (max 500 KB) | | Format | — | A4 | Paper size: A4, A3, Letter, Legal | | Landscape | — | false | Landscape orientation | | Margin Top/Bottom/Left/Right | — | — | CSS lengths e.g. 20mm, 1in | | Print Background | — | true | Render CSS backgrounds |

Generate PDF — Multi-Page

Accepts a JSON array of page objects. Each page can have its own layout:

[
  { "html": "<h1>Cover</h1>", "format": "A4" },
  { "html": "<p>Content</p>", "format": "A4", "landscape": true }
]

Output: { url, pages, tokens_used, request_id }

Upload Temp File

Uploads a binary file from the workflow for use inside HTML <img src="..."> or CSS references. Files are publicly accessible for 24 hours, then auto-deleted.

Connect any node that produces binary data (e.g. HTTP Request, Read Binary File) before this node, then set the Input Binary Field to the binary property name.

Output: { url, key, size, expires_in, expires_at }

Get Balance

Returns the token balance for your API key.

Output: { tokens: number }

Credentials

Add an AgentGen API credential and paste your API key. Get one at agent-gen.com.

n8n will automatically test the credential against the /v1/balance endpoint when you click Test credential.

Compatibility

• n8n ≥ 1.0.0
• Tested against n8n-workflow 2.x

Resources

• AgentGen documentation
• n8n community nodes documentation
• Source code

License

MIT