Documentation

LiveAI — n8n Community Nodes

n8n community nodes for generating media with the local model API, handling webhooks, and integrating with the official Instagram Graph API.

  • Live: video generation with ZeroScope 576w on CPU.
  • Image 2.6: image generation with Tiny SD on CPU.
  • Local media generation needs no API key or paid hosted endpoint.
  • Completed generations are returned as an n8n binary property named data.
  • Instagram actions use the official Instagram Login API with a Meta access token.

Requirements

  • n8n 2.46 or newer (Node.js 20.15 or newer).
  • The model API running at an address reachable from the n8n process.
  • The API host must have the model files and RAM available for CPU inference. Video generation is slow and uses an 8-frame, 256 × 256 preset.

Install

The package is published to npm as n8n-nodes-liveai and can be installed under Settings → Community nodes. To install this checkout locally for testing, build it first and use the local folder in n8n's community-node installation.

Configure

Set API Base URL to an address reachable from n8n. http://127.0.0.1:8000 only works when n8n and the API share the same host/network namespace. In Docker, use the API service's container hostname, for example http://model-api:8000; localhost inside the n8n container is not the API container.

Choose a model and provide a prompt between 3 and 2000 characters. To use incoming data, map a text property such as ={{ $json.prompt }}; that property must contain a string. By default, the node waits for completion and returns the PNG or MP4 as binary.data. Turn off Wait for generation to return the API job ID immediately instead. API validation errors are surfaced in the node's execution error.

Generation trigger

The LiveAI Generation Trigger polls GET /api/jobs and emits generation.complete or generation.error events. Keep the API process running and use the same reachable API Base URL. Deploy the updated API in this checkout; earlier API builds do not include the job-list endpoint.

Webhooks

  • LiveAI Webhook starts a workflow from a GET, POST, or PUT request. Use the test URL while listening in the editor, and the production URL after activating the workflow. Enable Bearer Token authentication and set a LiveAI Webhook Shared Secret credential before exposing a generic endpoint publicly.
  • Instagram Webhook Verify and Instagram Webhook Events are separate GET/POST triggers. Use the same path for both so they form one callback URL; activate both workflows. The verification node answers Meta's hub.challenge, and the events node checks X-Hub-Signature-256 using the Meta App Secret before emitting selected comments/mentions.
  • In the Meta developer dashboard, subscribe the app to the required Instagram webhook fields and configure the public HTTPS callback URL, verify token, and app secret. n8n must be publicly reachable over HTTPS (or exposed via a secure tunnel).

Instagram

Create the Instagram Graph API (Instagram Login) credential with an Instagram User Access Token, Instagram User ID, an API version enabled for the Meta app, the Meta App Secret, and the webhook verify token. Store secrets only in n8n credentials. The app/account must have Instagram Login, a professional account, and the required Meta permissions for content publishing, comments, insights, and webhooks (for example instagram_business_basic, instagram_business_content_publish, instagram_business_manage_comments, and instagram_business_manage_insights). Meta must grant the permissions requested by the selected operations.

The Instagram node supports image feed posts, Reels, image/video Stories, listing and replying to comments, and account insights. Media URLs must be public and reachable by Meta. Permission availability and supported insight metrics depend on the Meta app, account, and Graph API version.

The local API has no API-key authentication. Bind it to a trusted local/private network; do not expose the unauthenticated service directly to the public internet.

The app's current CPU models are third-party checkpoints with their own licenses. ZeroScope is CC-BY-NC-4.0; check each model card and license before commercial use.

Publish

From n8n-community-node/, run:

npm install
npm pack --dry-run
npm run publish:npm

The publish script asks for the current numeric authenticator code and passes it explicitly to npm. Enter the code in the terminal when prompted; it stays hidden and is not saved. Publishing also requires an npm account with permission to publish n8n-nodes-liveai. If your account uses a security key instead of an authenticator code, publish interactively with npm publish --access public and complete npm's security-key challenge.

Alternatively, create an npm granular access token with Read and write (publish and stage) permission and Bypass two-factor authentication enabled. Configure it in your local npm user config; never commit or share the token. Then run:

NPM_PUBLISH_WITH_BYPASS_2FA=1 npm run publish:npm

Discussion