waoowaoo README

The project's README from github.com/waooAI/waoowaoo. As one markdown file: README.md.

waooAI%2Fwaoowaoo | Trendshift

An AI creative workspace for images and videos: develop ideas with the right-hand Assistant, upload references, and organize and refine your work on a canvas.

Join Waitlist · Report Bug

English · 简体中文 · 日本語 · 한국어

[!IMPORTANT] Preview release: we are iterating rapidly, and some bugs and rough edges remain. Join the community to share feedback and follow updates.

WeChat / community


✨ Features

This preview exposes OpenRouter configuration. Available models include GPT Image 2, Nano Banana variants, Seedance variants, and MiniMax H3 / H3 Max. Availability and charges depend on the provider. H3 Max currently accepts a single first frame in this application, not a first/last-frame pair. Music and voiceover controls are not included in this preview.

The application UI currently supports Chinese and English. Japanese and Korean are README translations.


🚀 Quick Start

Copy the following into a local coding assistant with terminal access. It will inspect your machine, install the required dependencies, and configure Docker for you. You may need to approve an operating-system installer or start Docker Desktop yourself.

Install the self-hosted preview of https://github.com/waooAI/waoowaoo on my computer.
Read the repository README, docs/INSTALL.md, and the selected GitHub Release first.
Use a published preview release and its prebuilt Docker images. Pin both the
application and the Codex runtime to the release's immutable image digests.
Check my OS, CPU architecture, Docker Engine/Desktop, Compose v2, Git, and flock;
install missing dependencies using the appropriate OS tools, with approval where required.
Use a new installation directory and preserve all existing containers, files, and data.
Generate unique local secrets and configure .env without printing or uploading secrets.
Follow the existing Worker bootstrap procedure; do not invent a second startup path.
Include docker/caddy/Caddyfile from the same release. Use the default Compose HTTPS entry:
SELF_HOSTED_HOST=localhost, SELF_HOSTED_HTTPS_PORT=1443; APP_HOST_PORT=13000 only redirects HTTP.
The overlay derives NEXTAUTH_URL; preserve Caddy's /data and /config named volumes.
Export only root.crt, explain its trust implications, and obtain my explicit approval
before helping me trust it on the browser's host OS (Windows trust is separate from WSL).
Never export root.key or bypass TLS checks. Verify https://localhost:1443 has no certificate
warning and the browser actually uses h2, including event streams across multiple tabs.
SSE tab concurrency is not the AI task concurrency limit.
Verify container health and that the application opens, then tell me the local URL.
Guide me to enter my OpenRouter API key in the application; do not request it in chat.
Do not start paid AI generations without my approval. If the release lacks a required
image or my platform is unsupported, explain the blocker instead of claiming success.

The release Compose setup starts Caddy automatically. After approving local certificate trust, open https://localhost:1443; port 13000 only redirects HTTP. Source development with npm run dev remains at http://localhost:3001.

The recommended distribution is prebuilt Docker images. You do not need to install Node.js, MySQL, Redis, Temporal, or FFmpeg on your host for this path; application dependencies run in containers. The complete installation instructions for your assistant and manual setup are in docs/INSTALL.md.


🔧 API Configuration

After launching, open your profile’s API configuration and add your OpenRouter API key. Provider calls are paid through your own account. Keep API keys out of chat and support logs.

Project data and media use local database and private MinIO storage; prompts and references are sent to the provider for requested AI tasks. Supported inline image references do not require a public media URL.

For manual setup, source builds, backups, and upgrades, see the installation guide.


📦 Tech Stack


📦 Preview


🤝 Contributing

This project is maintained by the core team. You are welcome to:


License

Starting with v0.5.0-beta.1, this distribution is licensed under Elastic License 2.0. Personal use, internal business use, modification, and redistribution are permitted subject to its terms. Providing third parties with hosted or managed access to a substantial set of the software’s features requires separate permission. Earlier releases retain their original licenses; third-party components retain their respective licenses. This is source-available software, not OSI-approved open source.


Made with ❤️ by waoowaoo team

Star History

Star History Chart

waoowaoo (waooAI/waoowaoo)

Searching Database…

14.6K ·GitHub
这是什么?这是一个用于可控影视制作的 AI 智能体平台,可以做短视频,也能做类似真人实拍风格的内容。它是一个创作工作区:你可以和 AI 助手一起打磨想法、上传参考素材,并在画布上生成和整理图片与视频。
这是托管服务,还是要自己运行?这是一个自托管的网页应用,需要你用 Docker 自行部署;文档中没有提到托管的 SaaS 版本,推荐的运行方式是使用预构建的 Docker 镜像。
怎么把它跑起来?把快速开始说明粘贴给一个能访问终端的本地编程助手,它会检查你的电脑、安装依赖并为你配置 Docker。发布版的 Compose 配置会启动 Caddy,并通过 HTTPS 提供应用服务。
我需要先安装 Node.js、MySQL 或 Redis 吗?不需要。预构建的 Docker 方案会在容器里运行 Node.js、MySQL、Redis、Temporal 和 FFmpeg,所以本地只需要 Docker。不过,要真正生成图片或视频,你需要自己的 OpenRouter API 密钥。
这个预览版缺什么或有什么限制?这是一个早期预览版,还有不少粗糙的地方。音乐和配音控制暂时还未加入;MiniMax H3 Max 模型只接受单张首帧,不支持首帧和尾帧的组合。
我的项目文件和提示词最终会存到哪里?项目数据和媒体文件保存在你自己的本地数据库和私有 MinIO 存储中。但提示词和参考图片会通过 OpenRouter 发送给你配置的 AI 服务商,用来完成生成任务。
许可证条款是什么?从 v0.5.0-beta.1 开始,本项目采用 Elastic License 2.0 发布。这是一种源码可用但非 OSI 认可的许可证,允许个人和企业内部使用;如果要将其作为托管或代管服务转售,则需要另外获得许可。
可以用哪些 AI 模型来生成内容?预览版提供 OpenRouter 配置,可以调用 GPT Image 2、Nano Banana 系列、Seedance 系列以及 MiniMax H3 / H3 Max 等模型。具体可用性和费用取决于你选择的服务商。
界面支持哪些语言?应用界面目前支持中文和英文。日语和韩语版本只是 README 的翻译,并不是应用内的语言选项。
生成的结果可以怎么处理?你可以基于已有的图片或视频再细化出一个新版本,同时保留原版。这样你可以反复调整结果,而不会丢失之前的输出。
Creator
waooAI
Size
12.3 MB
Stars
14.6K
Age
8mo
Commits · 90 Days