Open-Generative-AI — AI 视频生成工具中文文档

Prerequisites

• Node.js (v18+)
• A Muapi.ai access key. Copy the generated key value into the app; do not enter the key name or label.

Clone the repository (with submodules — required for the workflow + agent packages)

git clone --recurse-submodules https://github.com/Anil-matcha/Open-Generative-AI.git cd Open-Generative-AI

Install dependencies + build workspace packages (studio, workflow, agents).

This step is REQUIRED — `npm install` alone is not enough; the workspaces

🌐 Try it Online — No Install Required

Hosted version: https://muapi.ai/open-generative-ai

Use all four studios (Image, Video, Lip Sync, Cinema) directly in your browser — no Node.js, no setup. Sign up for a free account to start generating. The hosted version is always up to date with the latest models.

Follow the creator for updates

---

macOS Installation Guide

Because the app is not notarized by Apple, macOS Gatekeeper will block it on first launch. Follow these steps:

Step 1 — Mount the DMG and drag the app to /Applications

Step 2 — Open Terminal and run:

xattr -cr "/Applications/Open Generative AI.app"

Step 3 — Right-click the app in /Applications → click Open → click Open again on the dialog

You only need to do this once. After that, the app opens normally.

Alternative (no Terminal): 1. Try to open the app — macOS will block it 2. Go to System Settings → Privacy & Security 3. Scroll down to find "Open Generative AI was blocked" 4. Click Open Anyway → Open

Windows Installation — SmartScreen warning fix

Windows SmartScreen may show a warning because the installer is not code-signed:

1. Click More info on the SmartScreen dialog
2. Click Run anyway

The app will install silently to %LocalAppData% with a Start Menu shortcut.

Ubuntu / Linux Installation

Linux artifacts are available when building with Electron Builder:

```bash

Build Linux installers (AppImage + .deb)

npm run electron:build:linux

Generated files are written to the `release/` folder:
- **AppImage** — portable, run directly after making executable:
  

- **.deb** — install on Debian/Ubuntu:
  

If AppImage fails to start on older systems, install `libfuse2`:

#### Ubuntu 24.04+ / AppArmor sandbox restriction

Ubuntu 24.04 and later enable a kernel security policy (`apparmor_restrict_unprivileged_userns`) that blocks Chromium's user-namespace sandbox. If the app fails to start silently or crashes immediately, you have two options:

**Option A — Recommended: install the `.deb` instead.**
The `.deb` package ships an AppArmor profile that grants the required permission automatically on install with no system-wide changes.

**Option B — Temporary system fix (AppImage users):**

This lasts until next reboot. To make it permanent:

---

Open Generative AI is a free, open-source AI image, video, cinema, and lip sync studio that brings creative workflows to everyone. No content filters, no prompt rejections, no guardrails — just full creative freedom. Powered by Muapi.ai, it supports text-to-image, image-to-image, text-to-video, image-to-video, and audio-driven lip sync generation across models like Flux, Nano Banana, Midjourney, Kling, Sora, Veo, Seedream, Infinite Talk, LTX Lipsync, Wan 2.2, and more — all from a sleek, modern interface you can self-host and customize.

Why Open Generative AI instead of other AI Video Platforms? - No filters — no content filters, no nanny guardrails, no prompt rejections - Free & open-source — no subscription, no vendor lock-in - Self-hosted — your data stays on your machine, full creative control - 200+ models — text-to-image, image-to-image, text-to-video, image-to-video, lip sync - Multi-image input — feed up to 14 reference images into compatible models - Lip Sync Studio — animate portraits or sync lips to any audio with 9 dedicated models - Extensible — add your own models, modify the UI, build on top of it

For a deep dive into the technical architecture and the philosophy behind the "Infinite Budget" cinema workflow, see our comprehensive guide and roadmap.

Setup

Most users want the desktop app, not this dev path. If you just want to run Open Generative AI on your machine, download a prebuilt installer instead — no Node.js required. The instructions below are for contributors building from source.

Pick the entry point that matches your goal:

• Desktop app (Electron) → npm run electron:dev
• Hosted web version (Next.js) → npm run dev

```bash

Production Build

npm run build
npm run start

Desktop App Build

Build native desktop apps with Electron:

```bash

Windows (NSIS installer — x64 + ARM64)

npm run electron:build:win

🚀 Quick Start

🔌 API Integration

The app communicates with Muapi.ai using a two-step pattern:

1. Submit — POST /api/v1/{model-endpoint} with prompt and parameters
2. Poll — GET /api/v1/predictions/{request_id}/result until status is completed

Authentication uses the x-api-key header. During development, a Vite proxy handles CORS by routing /api requests to https://api.muapi.ai.

File uploads use POST /api/v1/upload_file (multipart/form-data) and return a hosted URL that is passed to image-conditioned models. For multi-image models the full images_list array is forwarded to the API in one request.

Lip sync jobs use the same two-step pattern: a dedicated processLipSync() method accepts image_url or video_url alongside audio_url, dispatches to the model's endpoint, and polls until the output video URL is available.

🔀 Workflow Studio

The Workflow Studio lets you build and run multi-step AI pipelines without writing code.

Key capabilities: - Templates — Start from pre-built workflows (image chains, video pipelines, and more) - My Workflows — Save and manage your own custom pipelines - Community — Browse and run workflows published by other users - Node-based Builder — Drag-and-drop visual editor to connect models and route outputs between steps - Playground — Run any workflow interactively with a form UI; results render inline - API execution — Every workflow is also callable via the Muapi API

💡 Want to add workflows to your own app? Check out Vibe Workflow — the open-source workflow engine powering this feature. Drop it into any project.

If you already cloned without --recurse-submodules, run this once:

git submodule update --init --recursive

Open Generative AI — Open-Source Alternative to AI Video Platforms

The free, open-source alternative to AI Video Platforms. Generate AI images and videos using 200+ state-of-the-art models — no content filters, no closed ecosystem, no subscription fees.

Community: Join Reddit & Discord for discussions and support

Latest Gemini Omni model from Google best prompts and resources: Gemini Omni Resources

🤖 Automate media generations with AI coding agents: Generative-Media-Skills — a library of skills that let agents like Claude Code, Codex, and other coding assistants drive 200+ image/video models end-to-end (prompt → generate → edit → stitch) directly from your terminal. Perfect for building automated media pipelines without touching a UI.