Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 10 additions & 5 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -217,9 +217,10 @@ jobs:
retention-days: 3
compression-level: 0

# Windows in Git's bash on GitHub's runner, with the Visual Studio Build Tools in its image (their image terms; we
# accept no licence and download no Microsoft files). The C runtime is the DLL one (the VC++ redistributable): ort's
# prebuilt ONNX Runtime is built against it, so crt-static doesn't link (LNK2019 on __imp_ symbols, 10-29).
# Windows in Git's bash on GitHub's runner, with Visual Studio in its image. The C runtime is the DLL one: ONNX
# Runtime is built against it (crt-static didn't link: LNK2019 on __imp_ symbols, 10-29), and Microsoft's
# onnxruntime.dll imports it too, so the VC++ runtime's DLLs ship beside raea.exe from this image's Visual Studio
# (tools/release/win-bundle.sh), as Microsoft documents for app-local deployment.
windows:
runs-on: ${{ (vars.RELEASE_WINDOWS_RUNNER && fromJSON(vars.RELEASE_WINDOWS_RUNNER)) || 'windows-latest' }}
timeout-minutes: 350
Expand Down Expand Up @@ -333,12 +334,16 @@ jobs:
# static runtime ort links by default is built for AVX2 and stopped raea.exe at start on CPUs without it
- name: ONNX Runtime (tools/release/onnxruntime.sh)
run: bash tools/release/onnxruntime.sh target/dist
# which DLLs raea needs from the machine (the CRT's come from the VC++ redistributable)
# and what a PC with nothing installed and no downloads needs beside raea.exe: the VC++ runtime (from this
# runner's Visual Studio), FFmpeg (raea's LGPL build) and uv, each with its licence
- name: The Windows bundle (tools/release/win-bundle.sh)
run: bash tools/release/win-bundle.sh target/dist
# which DLLs raea needs from the machine (the CRT's now ship beside it: win-bundle.sh)
- name: What raea.exe imports
run: |
{ echo '### what raea.exe, raea_bundle.dll, raea-perceive.exe and onnxruntime.dll import'; echo '```'
dumpbin=$(ls "/c/Program Files/Microsoft Visual Studio"/*/*/VC/Tools/MSVC/*/bin/HostX64/x64/dumpbin.exe | head -1)
"$dumpbin" -nologo -dependents target/dist/raea.exe target/dist/raea_bundle.dll target/dist/raea-perceive.exe target/dist/onnxruntime.dll | grep -iE '\.dll$|Dump of' | sed 's/^ *//'
"$dumpbin" -nologo -dependents target/dist/raea.exe target/dist/raea_bundle.dll target/dist/raea-perceive.exe target/dist/onnxruntime.dll target/dist/ffmpeg.exe | grep -iE '\.dll$|Dump of' | sed 's/^ *//'
echo '```'; } | tee -a "$GITHUB_STEP_SUMMARY" || true
# release.sh's checks render on Mesa's lavapipe (software Vulkan, MIT; on the runner only, never in the zip): the
# runner has no GPU, and WARP, Windows' own software DX12, crashes compiling one of Bevy's compute shaders there
Expand Down
49 changes: 49 additions & 0 deletions .github/workflows/tools-ffmpeg.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# FFmpeg for Windows as raea ships it (tools/release/ffmpeg-win.sh): built on Linux with mingw-w64 and published once
# as the prerelease tools-ffmpeg-<version>-lgpl, with FFmpeg's source tarball, its signature and the script, which are
# its complete source (LGPL 2.1 or later). io/assets/src/setup.rs pins the zip by its
# sha256, so a published zip is never replaced: a run whose release already holds one only builds it and says
# whether its own sha256 differs.
name: tools-ffmpeg
on:
workflow_dispatch:
push:
paths: [tools/release/ffmpeg-win.sh, .github/workflows/tools-ffmpeg.yml]
permissions:
contents: write
jobs:
build:
runs-on: ubuntu-24.04
timeout-minutes: 60
steps:
- uses: actions/checkout@v4
with:
lfs: false
# the x86_64 cross compiler only, and non-interactive: an install that asks (needrestart, debconf) waits forever.
# The runner's own EC2 mirror has trickled (35 MB in 11 minutes, 11-19), so apt reads Ubuntu's archive first
# and Azure's mirror after it, gives up on a stalled request and retries.
- name: mingw-w64
env:
DEBIAN_FRONTEND: noninteractive
NEEDRESTART_MODE: a
run: |
printf 'http://archive.ubuntu.com/ubuntu/\tpriority:1\nhttp://azure.archive.ubuntu.com/ubuntu/\tpriority:2\n' | sudo tee /etc/apt/apt-mirrors.txt
o="-o Acquire::Retries=5 -o Acquire::http::Timeout=30"
sudo -E apt-get $o update -q
sudo -E apt-get $o install -y -q --no-install-recommends gcc-mingw-w64-x86-64 g++-mingw-w64-x86-64 binutils-mingw-w64-x86-64 libz-mingw-w64-dev nasm make pkg-config xz-utils zip
timeout-minutes: 25
- name: build
run: bash tools/release/ffmpeg-win.sh out
- name: publish (once)
env:
GH_TOKEN: ${{ github.token }}
run: |
v=$(sed -n 's/^v=//p' tools/release/ffmpeg-win.sh)
tag=tools-ffmpeg-$v-lgpl; zip=ffmpeg-$v-lgpl-win64.zip
if gh release view "$tag" --json assets -q '.assets[].name' 2>/dev/null | grep -qx "$zip"; then
echo "$tag already has $zip (never replaced); this run's: $(cat out/$zip.sha256)"; exit 0
fi
curl -fsSL -o "out/ffmpeg-$v.tar.xz.asc" "https://ffmpeg.org/releases/ffmpeg-$v.tar.xz.asc"
cp tools/release/ffmpeg-win.sh out/
gh release view "$tag" >/dev/null 2>&1 || gh release create "$tag" --prerelease --title "FFmpeg $v for Windows (LGPL), as raea ships it" \
--notes "FFmpeg $v cross-built for Windows x64 by tools/release/ffmpeg-win.sh: static, FFmpeg's own code, zlib and libvpx's decoders (BSD), LGPL 2.1 or later; its H.264 encoder is Windows' own (Media Foundation). Its complete source is ffmpeg-$v.tar.xz (with FFmpeg's signature), the libvpx tarball and ffmpeg-win.sh, attached here. raea ships it beside raea.exe on Windows and fetches it where it isn't."
gh release upload "$tag" "out/$zip" "out/$zip.sha256" "out/ffmpeg-$v.tar.xz" "out/ffmpeg-$v.tar.xz.asc" out/libvpx-*.tar.gz out/ffmpeg-win.sh
34 changes: 34 additions & 0 deletions .github/workflows/tools-git-sources.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# The complete corresponding source of the Git for Windows the Windows app ships (tools/release/git-sources.sh),
# published once as the prerelease tools-git-<tag>-sources, which the app's git\SOURCE.txt names: GPLv2 section 3
# asks whoever distributes Git to make it available, and dugite-native's own repository isn't all of it (Git for
# Windows' MSYS2 runtime, bash, curl and the rest are built from their own source packages). A run whose release
# already holds the archive changes nothing.
name: tools-git-sources
on:
workflow_dispatch:
push:
paths: [tools/release/git-sources.sh, .github/workflows/tools-git-sources.yml]
permissions:
contents: write
jobs:
sources:
runs-on: ubuntu-24.04
timeout-minutes: 60
env:
GH_TOKEN: ${{ github.token }}
steps:
- uses: actions/checkout@v4
with:
lfs: false
- name: publish (once)
run: |
t=$(sed -n 's/^tag=//p' tools/release/git-sources.sh)
tag=tools-git-$t-sources; tar=git-for-windows-$t-sources.tar
if gh release view "$tag" --json assets -q '.assets[].name' 2>/dev/null | grep -qx "$tar"; then
echo "$tag already has $tar"; exit 0
fi
bash tools/release/git-sources.sh out
cp tools/release/git-sources.sh out/
gh release view "$tag" >/dev/null 2>&1 || gh release create "$tag" --prerelease --title "Git for Windows ($t) sources, as raea's Windows app ships it" \
--notes "The complete corresponding source of the Git for Windows (dugite-native $t) that raea's Windows app ships in its git folder: each package of its etc/package-versions.txt as the source package it was built from, from Git for Windows' pacman repository or MSYS2's source mirror (SOURCES.tsv inside says which), collected by git-sources.sh, attached here. raea runs Git as a separate program."
gh release upload "$tag" "out/$tar" "out/$tar.sha256" out/git-sources.sh
2 changes: 2 additions & 0 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 10 additions & 2 deletions NOTICE
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,16 @@ animato (MIT OR Apache-2.0), usvg and resvg (Apache-2.0 OR MIT), mediabunny (MPL

The Windows build (docs/ports.feature PT20) adds: junction 1.4.2 (MIT, node_modules' links in io/npm) and windows-sys
0.61.2 (Microsoft, MIT OR Apache-2.0, in io/trace); every build has dunce 1.0.5 (CC0-1.0 OR MIT-0 OR Apache-2.0, plain
paths for Windows in runtime/bundle). It ships none of Microsoft's C runtime or SDK files: the runtime comes from the
Microsoft Visual C++ Redistributable, installed on the machine.
paths for Windows in runtime/bundle). Its bin\ also carries, each with its licence beside it (tools/release/win-bundle.sh):
Microsoft's Visual C++ runtime (vcruntime140.dll, vcruntime140_1.dll, msvcp140.dll, msvcp140_1.dll), redistributed
under Microsoft's Visual Studio licence terms; ONNX Runtime's onnxruntime.dll (Microsoft, MIT);
FFmpeg 9.0.2 (ffmpeg.exe, ffprobe.exe; LGPL-2.1-or-later), built from FFmpeg's release with FFmpeg's own code, zlib
and libvpx 1.17.0's decoders (BSD-3-Clause with the WebM project's patent grant: libvpx-LICENSE.txt,
libvpx-PATENTS.txt) by tools/release/ffmpeg-win.sh, its H.264 encoder Windows' own (Media Foundation), its source
published as the release tools-ffmpeg-9.0.2-lgpl;
uv (uv.exe; Astral, MIT OR Apache-2.0).
The Windows app adds Git for Windows with Git LFS (dugite-native; GPLv2 and its parts' licences, in git\), which raea
runs as a separate program; its complete corresponding source is published as the release tools-git-<tag>-sources.
The native target (engine/rune, docs/targets.feature) builds on Rune (https://github.com/anomalyco/rune, Copyright
2026 Anomaly, MIT; LICENSES/rune-0.0.1/repository-LICENSE): rune, rune-kit and their crates, by a pinned rev.

Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,8 +86,8 @@ 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.
It does the same under `~\.raea` and adds raea to your PATH. raea needs a DirectX 12 or Vulkan GPU driver; what
else it needs (the Visual C++ runtime, FFmpeg and uv) is in its `bin\` folder.

## Hello

Expand Down
2 changes: 2 additions & 0 deletions apps/notes/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ description = "A person's notes on a project as files the work is held to (docs/
# Note and Ask, the project found by its .raea/project, and the world a note is an entity in
raea-core-facts = { path = "../../core/facts" }
raea-io-home = { path = "../../io/home" }
# the H.264 encoder this machine's ffmpeg has, for a clip a person plays (raea_io_ffmpeg::h264)
raea-io-ffmpeg = { path = "../../io/ffmpeg" }
# when a run of an ask's check was (UTC), as raea check stamps its record
raea-io-trace = { path = "../../io/trace" }
# what each ask has been through, kept as JSON (state.rs)
Expand Down
3 changes: 2 additions & 1 deletion apps/notes/src/check.rs
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,8 @@ fn cut(out: &Path, [a, b]: [i64; 2], fps: f64, to: &Path) -> R<()> {
}
let (from, len) = (format!("{:.4}", a as f64 / fps), format!("{:.4}", (b - a) as f64 / fps));
let args = ["-hide_banner", "-loglevel", "error", "-y", "-ss", &from, "-i"];
let o = std::process::Command::new("ffmpeg").args(args).arg(out).args(["-t", &len, "-c:v", "libx264", "-pix_fmt", "yuv420p", "-c:a", "aac"]).arg(to).output().map_err(|e| format!("ffmpeg: {e}"))?;
let h264 = raea_io_ffmpeg::h264().ok_or("ffmpeg here has no H.264 encoder (libx264, Windows' h264_mf or VideoToolbox's) to cut the clip with")?;
let o = std::process::Command::new("ffmpeg").args(args).arg(out).args(["-t", &len]).args(h264).args(["-c:a", "aac"]).arg(to).output().map_err(|e| format!("ffmpeg: {e}"))?;
if !o.status.success() {
return Err(format!("ffmpeg: {}", String::from_utf8_lossy(&o.stderr).trim()));
}
Expand Down
15 changes: 10 additions & 5 deletions docs/manual/whats-new/0.1.8.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,11 @@ On Windows, in PowerShell: `irm https://raea.io/install.ps1 | iex`.
## What changed since 0.1.7

**raea on Windows works.**
- ChatGPT, Claude, Gemini, OpenCode and Kimi install and connect on a Windows PC. A workspace is made even when Git
isn't installed.
- Nothing needs installing first, and nothing has to download. The app carries what raea needs from outside it:
Git, FFmpeg, uv (which sets up the local models) and Microsoft's Visual C++ runtime, so it works on a work PC
that blocks downloads. Before, raea.exe wouldn't start without the Visual C++ Redistributable, and a workspace
couldn't be made without Git.
- ChatGPT, Claude, Gemini, OpenCode and Kimi install and connect on a Windows PC.
- The app calls your PC a PC: Ctrl, not ⌘, everywhere, the whiteboard too.
- The installer asks where raea goes. It suggests a folder in your own profile, takes any empty folder you can
write to (or the folder raea is already in), and says why it won't use one that already holds other files. An update goes
Expand All @@ -35,9 +38,11 @@ On Windows, in PowerShell: `irm https://raea.io/install.ps1 | iex`.
(#155) and on Intel's integrated graphics. 3D on DirectX 12 is now drawn as on a Mac; with `WGPU_BACKEND=dx12`
set by hand, 0.1.7 drew a scene's shapes into one another.
- A phone's or a camera's video plays, probes and checks. raea's own decoders read H.264 without B-frames, which is
what raea writes. The first time you open a video they can't read (most phone and camera footage: H.264 with
B-frames, HEVC, VP9), raea fetches FFmpeg once, about 114 MB, and checks it before use. Nothing needs installing
first.
what raea writes, and the FFmpeg in the app reads the rest (most phone and camera footage: H.264 with B-frames,
HEVC, VP9). It's built from FFmpeg's own source with no GPL part (FFmpeg's code and libvpx's decoders, for
WebM with transparency), so its licence is the LGPL, and its source is published beside raea's releases. A clip
raea cuts for you to play, such as `raea notes check`'s, uses Windows' own H.264 encoder. With raea from the zip and no FFmpeg on the PC, raea fetches
the same build once and checks it before use.
- Agents' npm tools and MCP servers start without a shell, and their arguments arrive as written in folders with
spaces or letters outside ASCII.
- raea starts on a PC whose processor has no AVX2, such as an Intel Core from 2011 or 2012 (#110). The ONNX Runtime
Expand Down
Loading
Loading