shinyobjectz/raea
Render Anything Engine: tell your AI what to make. Videos, motion graphics, 3D and games as React and TypeScript, rendered on your own GPU. Rust + Bevy, macOS, Linux and Windows.
raea — Render Anything Engine (누구나 사용 가능)
그것은 무엇인가. raea는 일반 지침을 완성된 미디어(비디오, 모션 그래픽, 3D 장면, 게임)로 변환하는 도구입니다. 원하는 것을 설명하면 AI가 코드(React 및 TypeScript, AI 모델이 이미 잘 알고 있는 언어)를 작성합니다. 그런 다음 raea는 해당 코드를 GPU에서 실시간 재생보다 빠르게 렌더링합니다.
현재 상태. raea는 "카나리아" 모드입니다. 매일 변경되며, 파괴적인 변경과 거친 부분이 예상됩니다. macOS(Apple Silicon), Linux(x86_64), Windows(x86_64, 최신이며 가장 테스트되지 않음)에서 실행됩니다.
작동 방식
"컴포지션"은 특정 시점의 한 프레임을 그리는 React 컴포넌트입니다. README의 최소 예제:
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
Apple Silicon Mac에서는 이 90프레임이 약 1초 만에 렌더링됩니다. 동일한 파일은 게임으로 라이브 재생(raea play), AI가 검사할 단일 프레임으로 렌더링(-o frame.png --frame 45), 또는 품질 기준에 대한 확인(raea check hello.mp4)이 가능합니다. raea init는 새 프로젝트를 시작하고, raea --help는 사용 가능한 모든 명령을 나열합니다.
생성할 수 있는 것
- 비디오 및 모션 그래픽 — 레이아웃, 텍스트, Tailwind 스타일, SVG 및 애니메이션을 GPU에서 합성하고 가능한 경우 하드웨어 인코딩합니다.
raea cut는 비디오에서 말한 내용에 따라 푸티지를 트리밍합니다.raea check는 누군가 보기 전에 텍스트 잘림, 낮은 대비, 안전하지 않은 영역, 프리즈 및 음량 문제를 자동으로 잡아냅니다. - 게임 — 입력, 물리, 사운드 및 3D를
raea play로 라이브 재생하거나raea export-game으로 독립 실행 프로그램으로 내보낼 수 있습니다. - 3D 장면 — TypeScript로 작성되고 Bevy 엔진(버전 0.20)으로 렌더링됩니다: 카메라, 조명, 재질, glTF 모델, 가우시안 스플랫 및 엔진에 컴파일된 Bevy 플러그인.
- 사운드 — 라이브 재생과 오프라인 렌더링 모두에 사용되는 단일 믹서로, 악기와 효과음, 그리고 효과음(사운드 효과)과 악기 음표를 위한 로컬 모델(
raea sao,raea tokensynth)을 포함합니다. - 에이전트 친화적 출력 — raea가 그리는 모든 것은 데이터로 쿼리 가능한 상태로 유지되므로 AI는 프레임을 렌더링하고, 보고, 인간의 개입 없이 문제를 수정할 수 있습니다.
AI 에이전트와 함께 사용
- 에이전트 스킬 — 설치 프로그램은
~/.claude/skills에 스킬 파일을 추가하여 Claude Code(또는 해당 폴더를 읽는 모든 에이전트)에게 raea 작업을 작성, 렌더링 및 확인하는 방법을 가르칩니다. 하나의 스킬은 컴포지션을 다루고, 다른 하나(raea-bevy)는 3D 및 게임을 다룹니다. - Claude Code 플러그인 —
/plugin marketplace add shinyobjectz/raea로 설치한 다음/plugin install raea@raea를 실행합니다. - 크래프트 가이드 —
raea guide는 모든 편집이 충족해야 하는 품질 기준과 피치, 설명, 스토리, 게임, 모션, 음악 및 레이아웃에 대한 가이드를 출력합니다.raea context PROJECT는 프로젝트 작업 전에 읽어야 할 것을 알려줍니다.
설치
macOS/Linux:
curl -fsSL https://raea.io/install | sh
이렇게 하면 raea 명령이 ~/.raea에 배치되고 ~/.local/bin에 링크되며 에이전트 스킬이 ~/.claude/skills에 추가됩니다. 다시 실행하여 업데이트합니다. 엔진은 무료이며 계정이 필요 없습니다. tarball과 체크섬은 릴리스 페이지에 있습니다.
Windows 10/11(PowerShell):
irm https://raea.io/install.ps1 | iex
이렇게 하면 ~\.raea 아래에 동일한 작업이 수행되고 raea가 PATH에 추가됩니다. Windows에는 Microsoft Visual C++ Redistributable(x64) 및 DirectX 12 또는 Vulkan GPU 드라이버가 필요합니다.
개인정보 및 네트워크 동작
raea는 자체적으로 아무것도 보내지 않습니다. 원격 측정, 충돌 보고서 또는 업데이트 확인이 없습니다. 네트워크 트래픽은 요청할 때만 발생합니다(컴포지션의 원격 URL, 처음 사용할 때 다운로드되는 모델, 또는 키를 보유한 공급자에서의 raea gen 단계). RAEA_OFFLINE=1을 설정하면 모든 네트워크 액세스를 거부합니다.
소스에서 빌드
요구 사항: Rust(안정), bun 및 플랫폼 라이브러리(macOS의 Xcode 명령줄 도구, Linux의 ALSA, fontconfig 및 Vulkan 라이브러리).
git clone https://github.com/shinyobjectz/raea && cd raea
cargo build --release -p raea-cli --no-default-features
target/release/raea render sdk/react/bench/games/pong/edit.tsx -o pong.mp4
--no-default-features는 공식 릴리스와 일치하는 공개 엔진을 빌드합니다. 기본 기능은 raea의 서명 서버가 서명한 Content Credentials라는 하나의 호스팅 서비스를 추가하지만, 이는 이 저장소의 일부가 아닙니다.
프로젝트 구조
워크스페이스는 순수한 빌딩 블록에서 명령줄 도구까지 계층화되어 있습니다.
| 폴더 | 용도 |
|---|---|
core/ |
순수 빌딩 블록: 커널 언어(K, CPU에서 해석되고 WGSL로 컴파일됨), 이징/애니메이션, 셰이프, 글꼴, 장면 및 와이어 형식 |
gpu/ |
단일 공유 GPU 장치 및 원격 측정 |
io/ |
디코드/인코드(VideoToolbox, 소프트웨어 코덱, AV1, 멀티플렉서), 파일, 네트워크, npm 패키지, 추적 |
systems/ |
엔진 시스템: 레이아웃, 캔버스, 합성, 필터, 믹싱, 음성, ML(ONNX Runtime), 푸티지 읽기, 조명, 3D 부품 접촉 검사, 스플랫 |
runtime/ |
컴포지션 실행: JavaScript 엔진 시임(macOS의 JavaScriptCore, 그 외 QuickJS), Bevy의 React 및 HTML, 베이킹, 인코딩, 라이브 재생 |
engine/ |
렌더러, 프로세스 내 TypeScript 번들러, Bevy 플러그인 카탈로그 및 raea 명령 자체 |
apps/ |
CLI 동사 뒤의 크레이트: check, play, games, media |
sdk/ |
TypeScript SDK, 3D/물리/오디오/비디오/UI 패키지, 크래프트 가이드 및 에이전트 스킬 |
vendor/ |
패치된 업스트림 크레이트(이유는 vendor/vendor.toml에 있음) |
tools/ |
빌드 및 릴리스 도우미 |
Gherkin(.feature 파일)으로 작성된 동작 사양은 설명하는 코드 옆에 있습니다.
라이선스
raea는 Functional Source License 1.1, ALv2 Future License(FSL-1.1-ALv2) 하에 있으며, 저작권은 Shane Murphy에게 있습니다. raea와 경쟁하는 제품을 제외한 모든 목적으로 사용, 변경, 구축 및 전달할 수 있습니다. 각 버전은 릴리스 후 2년 후 Apache-2.0이 됩니다. 타사 구성 요소는 자체 라이선스를 유지합니다(NOTICE 참조).
위의 모든 사실은 프로젝트 README에서 직접 가져온 것입니다. 해당 문서에 명시된 내용을 넘어 추가되거나 추론된 것은 없습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트