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 场景或游戏描述给 AI 智能体,由它来制作。它使用 React 和 TypeScript 编写,并在你自己的 GPU 上渲染。
它是视频编辑器还是游戏引擎?两者都不完全是。它是一个渲染引擎,通过 raea 命令可以把合成作品渲染成视频,也可以作为游戏实时运行,并且专为由 AI 智能体驱动而设计。
代码是我自己写,还是 AI 来写?两种都可以。合成作品是一个 React 组件,负责绘制某一时刻的一帧画面,所以既可以由智能体来编写,也可以由你自己动手写。
运行之前,我的电脑需要准备什么?无需账号。raea gen 步骤只有在你持有某个 AI 服务商的密钥时才会调用该服务商。在 Windows 上,你需要 Microsoft Visual C++ Redistributable (x64) 以及支持 DirectX 12 或 Vulkan 的 GPU 驱动。从源码构建还需要 Rust(stable 版本)和 bun。
现在就可以稳定使用吗?还不行。它是每天都在变化的 canary 版本,预计会出现破坏性变更,文档也可能有缺漏。Windows 版本是最新的,测试也最少。
我能完全离线使用吗?可以。设置 RAEAOFFLINE=1 后,所有网络访问都会被拒绝。
它会把我的数据发送到别处吗?不会。它不发送遥测数据、崩溃报告或更新检查。只有在你主动要求时才会联网,例如合成作品中使用了远程 URL、首次使用时下载模型,或你配置的服务商步骤。
在我的硬件上能跑得流畅吗?它会调用你的 GPU,并在机器支持的情况下使用硬件编码。README 中的速度示例(约一秒渲染 90 帧)来自一台 Apple Silicon 芯片的 Mac。
除了视频,它还能做什么?它可以制作游戏,你可以用 raea play 实时游玩,也可以将游戏导出为独立程序。它还能用 TypeScript 绘制 3D 场景,支持摄像机、灯光、材质和 glTF 模型,使用 Bevy 0.20。
智能体如何检查自己的工作?它会渲染一帧画面,查看后修正其中的问题。raea check 会在任何人观看之前标出被截断的文字、对比度低、超出安全区域的部分、画面定格以及响度问题。
它能和 Claude Code 一起用吗?可以。运行 /plugin marketplace add shinyobjectz/raea,然后运行 /plugin install raea@raea。智能体技能会教 Claude Code 如何编写、渲染和检查合成作品。
大小
95.3 MB
星标
2.7K
时长
1个月
提交 · 90 天