## Summary The README showcase now highlights three complete projects: THRESHOLD, Raven RSI, and Raven's product launch kit. Each project pairs a concise description with hosted videos, posters, presentations, and website or README previews. - Polish the English and Chinese titles, descriptions, and media labels. - Preserve the previous 11 examples in `docs/showcase.md` and `docs/showcase.zh-CN.md`, with links from both READMEs and the documentation index. - Keep all media hosted externally; this change contains five Markdown files. ## Type - [ ] Fix - [ ] Feature - [x] Docs - [ ] CI / tooling - [ ] Refactor - [ ] Other ## Verification - [x] Relevant tests pass locally - [x] Relevant lint / type checks pass locally - [x] User-facing docs or screenshots are updated when needed Commands run after rebasing onto the current target: - `rtk proxy uv run --no-sync --all-extras pytest tests/test_living_docs.py tests/test_docs_site.py tests/test_docker_runtime.py tests/test_cli_onboard_commands.py::test_readme_quickstart_matches_the_installer -q` - 28 passed. - `rtk proxy uv run --no-sync pre-commit run --from-ref origin/main --to-ref HEAD` - all applicable hooks passed, including private-key detection. - `rtk proxy env UV_NO_SYNC=1 make check-large-files check-source-language COMMIT_RANGE=origin/main..HEAD` - passed. - `rtk proxy env PYTHONPATH=. uv run --no-sync python scripts/check_commit_messages.py origin/main..HEAD` - passed. - `rtk proxy git diff --check origin/main...HEAD` - passed. The migrated showcase bodies match their originals byte for byte. GitHub Markdown rendering produces three project headings, three tables, 11 images, and two video players per README, with no unrendered bold markers. Relative links and domain terminology were checked. All five project website links returned HTTP 200. Requests to the 19 GitHub attachment URLs returned HTTP 403 or timed out; a direct GET retry also timed out, so media payload delivery could not be revalidated from this environment. Validation is scoped to documentation. Type checking is not applicable to these Markdown-only changes. The full application and integration suites were not run, and the showcase experiments were not rerun. ## Risk - [x] Security impact considered - [x] Backward compatibility considered - [x] Rollback path is clear for risky changes This changes the README presentation and adds navigation to the full galleries. Runtime behavior, configuration, and dependencies are unchanged. Media remains dependent on its external hosting. Revert this documentation change to restore the previous layout. ## Related Issues N/A
98 lines
9.7 KiB
Markdown
98 lines
9.7 KiB
Markdown
# Raven Showcase
|
|
|
|
[Back to README](../README.md) · [中文](showcase.zh-CN.md)
|
|
|
|
Real runs, each captured from Raven's task graph. The graph shows the
|
|
orchestration Raven generates for the task; below it is what the run produced.
|
|
|
|
<table>
|
|
<tr>
|
|
<td valign="top"><p align="center"><b>An FPS boss arena game built in Godot 4 (~4 days of autonomous operation)</b></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/951e35bd-ff9c-4456-b539-32dd192827e1"><img src="https://github.com/user-attachments/assets/951e35bd-ff9c-4456-b539-32dd192827e1" alt="Task graph: three Raven-Code nodes running in sequence across 42 game rounds" width="100%"></a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">
|
|
|
|
https://github.com/user-attachments/assets/44724e3e-6564-467a-b422-473aa8f474bd
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><b>A presentation about Song-dynasty domestic aesthetics (costs ~$0.80)</b></p></td>
|
|
<td width="50%" valign="top"><p align="center"><b>A presentation about how ancient Greece was whitewashed (costs ~$0.80)</b></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/7bf450bb-3d5c-4d4a-826a-e5a06344d489"><img src="https://github.com/user-attachments/assets/7bf450bb-3d5c-4d4a-826a-e5a06344d489" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/c8e9ac77-0377-487e-9d07-fb4fe51a0257"><img src="https://github.com/user-attachments/assets/c8e9ac77-0377-487e-9d07-fb4fe51a0257" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/92fafcb0-8e17-4f17-819f-d18d970f2c3c"><img src="https://github.com/user-attachments/assets/92fafcb0-8e17-4f17-819f-d18d970f2c3c" alt="Cover, slides and closing slide of the Song-dynasty aesthetics deck" width="100%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/82801a70-edb3-4ca7-b7f0-a2c11431d6d3"><img src="https://github.com/user-attachments/assets/82801a70-edb3-4ca7-b7f0-a2c11431d6d3" alt="Cover, slides and closing slide of the Greek polychromy deck" width="100%"></a></p></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><b>A presentation about how pop music is manufactured (costs ~$0.80)</b></p></td>
|
|
<td width="50%" valign="top"><p align="center"><b>A presentation about a century of abstract art (costs ~$0.80)</b></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/032fdf6e-8b65-49a0-92ba-2ea3066a7451"><img src="https://github.com/user-attachments/assets/032fdf6e-8b65-49a0-92ba-2ea3066a7451" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="100%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/4b606bae-667e-4f2f-ae7d-2880b47ddbf6"><img src="https://github.com/user-attachments/assets/4b606bae-667e-4f2f-ae7d-2880b47ddbf6" alt="Task graph: three Raven-Research nodes running in parallel into a synthesis node, then one Raven-Design node" width="98%"></a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/350f902e-838a-4233-af44-d86c3240e757"><img src="https://github.com/user-attachments/assets/350f902e-838a-4233-af44-d86c3240e757" alt="Cover, slides and closing slide of the pop music deck" width="100%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/4feda7e4-bb2e-4d63-b592-dc75c77f3406"><img src="https://github.com/user-attachments/assets/4feda7e4-bb2e-4d63-b592-dc75c77f3406" alt="Cover, slides and closing slide of the abstract art deck" width="100%"></a></p></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><b>A poster about how six agent-orchestration frameworks compare</b></p></td>
|
|
<td width="50%" valign="top"><p align="center"><b>Data analysis on a parameter sweep</b></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/db8ac2b2-bf18-4d18-a8f4-6d4904a7a0c4"><img src="https://github.com/user-attachments/assets/db8ac2b2-bf18-4d18-a8f4-6d4904a7a0c4" alt="Task graph: two Raven-Research nodes running in parallel into one Raven-Design node" width="100%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/0048ee55-9102-407c-a58a-366dc0a8a9da"><img src="https://github.com/user-attachments/assets/0048ee55-9102-407c-a58a-366dc0a8a9da" alt="Task graph: Raven-Code into Raven-Oncall into Raven-Design, run in sequence" width="100%"></a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/15396c71-10ff-4077-9193-44c3a25d2d60"><img src="https://github.com/user-attachments/assets/15396c71-10ff-4077-9193-44c3a25d2d60" alt="Comparison board: six orchestration frameworks against four dimensions, each tagged explicit graph or canvas, declared task flow, or dynamic at runtime" width="100%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/9e0ee7b0-4265-4b84-bb50-8034406894b3"><img src="https://github.com/user-attachments/assets/9e0ee7b0-4265-4b84-bb50-8034406894b3" alt="Retrieval sweep dashboard: recall@k is set by top_k alone and latency stays broadly flat, with a sixteen-cell grid of measured recall and latency and the best cell ringed at top_k 10, chunk_size 1024" width="99%"></a></p></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><b>A poster about how light pollution steals wildlife sleep</b></p></td>
|
|
<td width="50%" valign="top"><p align="center"><b>A website about why GPS needs a fourth satellite</b></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/d3e4c873-cf95-4011-8471-0fda72778cfd"><img src="https://github.com/user-attachments/assets/d3e4c873-cf95-4011-8471-0fda72778cfd" alt="Task graph: three Raven-Research nodes in parallel into a Raven-Code node; that node and a Raven-Design plate node running alongside them both feed the final Raven-Design node" width="83%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/9754976b-11ff-4738-b53d-0621ec6ae7da"><img src="https://github.com/user-attachments/assets/9754976b-11ff-4738-b53d-0621ec6ae7da" alt="Task graph: two Raven-Code nodes in parallel into a Raven-Oncall cross-check; that node and a Raven-Design plate node running alongside them both feed the final Raven-Design node" width="100%"></a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/fd70acb8-ec48-4adc-bf51-1e1c316e939e"><img src="https://github.com/user-attachments/assets/fd70acb8-ec48-4adc-bf51-1e1c316e939e" alt="Key visual plus the derived series: street poster, data panel, social square and wide banner" width="100%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/dbf6fa43-5a68-4e6a-95d4-a9902770ee4b"><img src="https://github.com/user-attachments/assets/dbf6fa43-5a68-4e6a-95d4-a9902770ee4b" alt="GPS trilateration explainer: the live page, and the fix at two, three and four satellites" width="97%"></a></p></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><b>A simulation that finds a beam's limit load by bisection</b></p></td>
|
|
<td width="50%" valign="top"><p align="center"><b>A dam-break simulation, tuned until the water stays bounded</b></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/05fd70ce-85ca-4f8a-9891-d9085d3f4783"><img src="https://github.com/user-attachments/assets/05fd70ce-85ca-4f8a-9891-d9085d3f4783" alt="Task graph: Raven-Research into Raven-Code into Raven-Oncall, run in sequence for a CalculiX cantilever plastic limit chain, 3 of 3 done in 5m21s, 1m28s and 4m11s" width="100%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/050707b5-2af9-4f29-9d65-1564e96fef9d"><img src="https://github.com/user-attachments/assets/050707b5-2af9-4f29-9d65-1564e96fef9d" alt="Task graph: Raven-Research into Raven-Code into Raven-Oncall, run in sequence for a dam-break chain, 3 of 3 done in 11m48s, 1m16s and 3m58s" width="100%"></a></p></td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/89878a01-ab5c-4070-8359-5bc34c3d58b7"><img src="https://github.com/user-attachments/assets/89878a01-ab5c-4070-8359-5bc34c3d58b7" alt="Limit-load search: a cantilever beam under rising load colored by von Mises stress, with the bisection bracket narrowing from 1800-2000 kN down to 3.125 kN over eight rounds" width="90%"></a></p></td>
|
|
<td width="50%" valign="top"><p align="center"><a href="https://github.com/user-attachments/assets/44f81db4-4c17-47be-ad3b-047e26762a24"><img src="https://github.com/user-attachments/assets/44f81db4-4c17-47be-ad3b-047e26762a24" alt="Dam-break solve: a collapsing water column resolved to fine free-surface structure, with the out-of-bounds water fraction falling from 1e0 to 1.36e-10 over seven rounds" width="90%"></a></p></td>
|
|
</tr>
|
|
</table>
|