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
Что это такое?Это платформа на базе агентов ИИ для управляемого производства фильмов и видео, от коротких роликов до контента в стиле игрового кино. Это творческая рабочая среда, где вы развиваете идеи вместе с ассистентом на базе ИИ, загружаете референсы, а также создаёте и упорядочиваете изображения и видео на холсте.
Это облачный сервис или я запускаю его сам?Это самостоятельно развёртываемое веб-приложение, которое вы устанавливаете с помощью Docker. В описании нет облачной версии (SaaS), а рекомендуемый способ запуска — готовый образ Docker.
Как мне его запустить?Вставьте инструкцию быстрого старта в локального ассистента для программирования с доступом к терминалу. Он проверит вашу систему, установит зависимости и настроит Docker, а релизная конфигурация Compose запустит Caddy и откроет приложение по HTTPS.
Нужно ли мне сначала установить Node.js, MySQL или Redis?Нет. Готовый путь с Docker запускает Node.js, MySQL, Redis, Temporal и FFmpeg внутри контейнеров, поэтому локально нужен только Docker. Чтобы реально генерировать изображения или видео, понадобится собственный ключ API OpenRouter.
Чего не хватает или что ограничено в этом превью?Это ранняя предварительная версия с шероховатостями. Элементов управления музыкой и озвучкой пока нет, а модель MiniMax H3 Max принимает только один первый кадр вместо пары «первый и последний кадр».
Куда попадают мои файлы проекта и промпты?Данные проекта и медиафайлы хранятся в вашей локальной базе данных и приватном хранилище MinIO. Промпты и референсные изображения отправляются провайдеру ИИ, которого вы настроили через OpenRouter, чтобы выполнить задачи генерации.
Каковы условия лицензии?Начиная с v0.5.0-beta.1 проект распространяется по лицензии Elastic License 2.0. Это лицензия с доступным исходным кодом, но не одобренная OSI. Она разрешает личное и внутреннее коммерческое использование, а для перепродажи в виде размещённого или управляемого сервиса требует отдельного разрешения.
Какие модели ИИ я могу использовать для генерации?Превью предоставляет конфигурацию 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