raea README

README проекта с github.com/shinyobjectz/raea. Одним файлом markdown: README.md.

raea's cat

raea

Render Anything Engine (for Anyone)

Tell your AI what to make. Videos, motion graphics, 3D and games, written as React and TypeScript
(the code your AI already writes) and rendered on your own GPU, faster than they play.

raea.io · Made in raea · Why raea · Docs · Releases

licence FSL-1.1-ALv2 latest release macOS, Apple Silicon Linux x86_64 Windows x86_64


0.1.6 (17 November 2026) is the latest release: the engine and the desktop app on macOS (Apple Silicon), Linux (x86_64) and, newest and least tested, Windows 10 and 11 (x86_64). raea is young and moves fast, with a release most days since 0.1.1 on 11 November: expect rough edges, and tell us what you hit in an issue, or from your agent with raea bug.

The app

The raea app is where you make video, 3D and games with your AI. You ask in a chat; your own AI (Claude, ChatGPT, Kimi or a local model) writes the raea code and renders it; what it makes lands in the project's feed, where you watch it, scrub it, mark it up and send it back with notes. Download it from raea.io for the Mac, Windows or Linux. It tells you when a new version is out; on the Mac it updates itself.

Goose Learns raea, the tutorial: the raea app with Goose on its stage

Goose Learns raea (5:50) is the tutorial: a dry narrator walks Goose through the app while he makes his own music video, from the first ask to the finished film. It was made in raea too, and its source is in raea-films.

What the app does now:

The app and the engine are free. Pro adds cloud storage, search across your computers and publishing; Team puts up to five people on one plan (pricing). Each release's notes are on the releases page.

Install

curl -fsSL https://raea.io/install | sh

The installer puts the raea command under ~/.raea, links it into ~/.local/bin, and adds raea's agent skills to ~/.claude/skills, so Claude Code (or any agent that reads that folder) knows how to write, render and check raea work. Run it again to update. The engine is free and needs no account. Tarballs and checksums are on the releases page.

On Windows 10 or 11, in PowerShell:

irm https://raea.io/install.ps1 | iex

It does the same under ~\.raea and adds raea to your PATH. raea needs the Microsoft Visual C++ Redistributable (x64), which most machines already have, and a DirectX 12 or Vulkan GPU driver.

Hello

A composition is a React component that draws a frame for a given moment:

import { AbsoluteFill, Composition, interpolate, registerRoot, useCurrentFrame } from "raea";

function Hello() {
  const f = useCurrentFrame();
  return <AbsoluteFill style={{ background: "#000", color: "#fff", fontSize: 120, opacity: interpolate(f, [0, 20], [0, 1]) }}>Hello</AbsoluteFill>;
}

registerRoot(() => <Composition id="hello" component={Hello} width={1920} height={1080} fps={30} durationInFrames={90} />);
raea render hello.tsx -o hello.mp4

On an Apple Silicon Mac those 90 frames render in about a second. The same file can play live as a game (raea play), render one frame for an agent to look at (-o frame.png --frame 45), or be checked against a quality floor (raea check hello.mp4). raea init starts a project, and raea --help lists every verb.

What it does

Made in raea

Films, music videos, a tutorial and a game made with raea are on media.raea.io. Six of them come with their source in raea-films: each project's code under Apache-2.0, to read, render and take apart, and its models, textures and sound for anyone with a free raea account.

Use it from your agent

Build from source

Requirements: Rust (rustup reads the pinned version from rust-toolchain.toml), bun and CMake. On macOS, Xcode's command-line tools; on Linux, the ALSA, fontconfig, udev, xkbcommon (with its X11 part, which the app targets' windows also load at run time) and Vulkan libraries and NASM (Ubuntu: cmake ninja-build nasm libasound2-dev libfontconfig1-dev libudev-dev libvulkan-dev libxkbcommon-dev libxkbcommon-x11-dev), as public CI installs them.

git clone https://github.com/shinyobjectz/raea && cd raea
cargo build --release -p raea-cli --no-default-features
for d in sdk/raea sdk/react/js sdk/react/tw; do (cd $d && bun install); done
target/release/raea render sdk/react/bench/games/pong/edit.tsx -o pong.mp4

--no-default-features builds the public engine, as the releases are. The default features add one hosted service, Content Credentials signed by raea's signing server, which isn't part of this repository. raea sends nothing on its own: no telemetry, crash reports or update checks. What reaches the network is what you ask for (a remote URL in a composition, a model downloaded on first use, a raea gen step on a provider you hold a key for), and RAEA_OFFLINE=1 refuses all of it. docs/settings.md lists the settings raea reads.

What's in here

The workspace is layered, from pure building blocks up to the command.

Folder What
core/ Pure building blocks: the kernel language (K, interpreted on the CPU and compiled to WGSL), easing and animation, shapes, fonts, the scene and wire formats
gpu/ The one shared GPU device and its telemetry
io/ Decode and encode (VideoToolbox, software codecs, AV1, a muxer), files, network, npm packages, traces
systems/ Engine systems: layout, canvas, compositing, filters, mixing, speech, ML on ONNX Runtime, footage reading, lighting, contact checks for 3D parts, splats
runtime/ Running a composition: the JavaScript engine seam (JavaScriptCore on macOS, QuickJS elsewhere), React and HTML on Bevy, baking, encode, live play
engine/ The renderer (engine/render), the in-process TypeScript bundler, the Bevy plugin catalog, and the raea command itself (engine/cli)
apps/ The crates behind the CLI's verbs: check, play, games, media
sdk/ raea, the TypeScript SDK (sdk/raea), its 3D, physics, audio, video and UI packages, the craft guides, and the agent skills
vendor/ Patched upstream crates, under their own licences (vendor/vendor.toml says why each is patched)
tools/ Build and release helpers

Behaviour specs written in Gherkin (.feature) sit beside the code they describe.

Licence

raea is under the Functional Source License 1.1, ALv2 Future License (FSL-1.1-ALv2), copyright Shane Murphy. Use it, change it, build on it and pass it on for anything except a product that competes with raea. Each version becomes Apache-2.0 two years after its release. Third-party parts keep their own licences; see NOTICE.

raea (shinyobjectz/raea)

Ищем в базе…

2.7K ·GitHub
Что это такое?Это движок рендеринга, в котором вы описываете ИИ-агенту видео, моушн-графику, 3D-сцену или игру. Он написан на React и TypeScript и выполняет рендеринг на вашем собственном GPU.
Это видеоредактор или игровой движок?Ни то ни другое в точности. Это движок рендеринга с командой raea, которая превращает композиции в видео или запускает их вживую как игры. Он рассчитан на управление ИИ-агентом.
Мне самому писать код или его пишет ИИ?Любой вариант. Композиция — это React-компонент, который рисует один кадр для заданного момента, поэтому её может написать ИИ-агент или вы сами.
Что нужно моей машине, прежде чем я смогу это запустить?Учётная запись не нужна. Шаг raea gen использует провайдер ИИ, только если у вас есть для него ключ. В Windows нужны Microsoft Visual C++ Redistributable (x64) и драйвер GPU с поддержкой DirectX 12 или Vulkan. Для сборки из исходников также нужны Rust (stable) и bun.
Достаточно ли он стабилен, чтобы пользоваться им сегодня?Пока нет. Это канареечная сборка, которая меняется каждый день, поэтому ломающие изменения и пробелы в документации ожидаемы. Сборка для Windows самая новая и наименее протестированная.
Могу ли я пользоваться им полностью офлайн?Да. Если задать RAEAOFFLINE=1, любое использование сети будет запрещено.
Он куда-нибудь отправляет мои данные?Нет. Он не отправляет телеметрию, отчёты о сбоях или проверки обновлений. Сеть используется только по вашему запросу: например, для удалённого URL в композиции, для модели, которая скачивается при первом использовании, или для шага с провайдером, который вы настроили.
Будет ли он хорошо работать на моём железе?Он использует ваш GPU и кодирует видео аппаратно, если в машине есть такая возможность. Пример скорости из README, 90 кадров примерно за секунду, получен на Mac с Apple Silicon.
Что он умеет создавать, кроме видео?Игры, в которые можно играть вживую через raea play, и экспортировать их как отдельную программу. Он также рисует 3D-сцены на TypeScript с камерами, светом, материалами и моделями glTF, используя Bevy 0.20.
Как агент проверяет свою работу?Он отрисовывает кадр, смотрит на него и исправляет ошибки. Команда raea check отмечает обрезанный текст, низкий контраст, небезопасные зоны, застывшие кадры и проблемы с громкостью до того, как кто-либо посмотрит видео.
Работает ли он с Claude Code?Да. Выполните /plugin marketplace add shinyobjectz/raea, а затем /plugin install raea@raea. Навыки агента учат Claude Code писать, рендерить и проверять композиции.
Автор
shinyobjectz
Размер
95.3 MB
Звёзды
2.7K
Возраст
1 мес
Коммиты · 90 дней