3D engine that AI agents drive
README: use the same layout as the other CodePawl repos
Nguyen Xuan Ana9a6b3460d3b
diff --git a/README.md b/README.mdindex 800cc5e6..e2420e1c 100644--- a/README.md+++ b/README.md@@ -1,53 +1,51 @@<p align="center">- <a href="https://67js.codepawl.com">- <picture>- <source media="(prefers-color-scheme: dark)" srcset="https://67js.codepawl.com/brand/wordmark-dark.svg" />- <img src="https://67js.codepawl.com/brand/wordmark-light.svg" alt="67js" width="144" />- </picture>- </a>+ <a href="https://67js.codepawl.com"><img src="https://67js.codepawl.com/previews/banner.jpg" alt="67js: a WebGL2 3D engine that AI agents drive, with an airport ramp, a Bistro street and an AI data center rendered by it" width="100%"></a></p>-<p align="center"><strong>A WebGL2 3D engine that AI agents drive.</strong></p>-<p align="center">- <a href="https://www.npmjs.com/package/@codepawlhq/67js"><img src="https://img.shields.io/npm/v/@codepawlhq/67js?color=3b6e22&label=npm" alt="npm version" /></a>- <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-3b6e22" alt="MIT license" /></a>- <img src="https://img.shields.io/badge/node-%E2%89%A520.19-3b6e22" alt="Node.js 20.19 or later" />-</p>--<p align="center">- <a href="https://67js.codepawl.com/showcase.html">Showcase</a> ·- <a href="https://67js.codepawl.com/docs.html">Documentation</a> ·- <a href="https://67js.codepawl.com/llms.txt">Guide for agents</a> ·- <a href="https://github.com/codepawl/67.js/blob/main/CHANGELOG.md">Changelog</a>-</p>--<p align="center">- <img src="https://67js.codepawl.com/previews/bistro-street.webp" alt="A Paris side street in the Bistro scene with red awnings, string lights and a blue sky, rendered by 67js" width="100%" />+ <a href="https://www.npmjs.com/package/@codepawlhq/67js"><img alt="npm version" src="https://img.shields.io/npm/v/@codepawlhq/67js?style=flat-square&label=npm&color=7CC765&labelColor=0A1D1A"></a>+ <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-E9F5F0?style=flat-square&labelColor=0A1D1A"></a>+ <img alt="Node.js 20.19 or later" src="https://img.shields.io/badge/node-%E2%89%A520.19-4DB6FF?style=flat-square&labelColor=0A1D1A">+ <img alt="MCP server for agents" src="https://img.shields.io/badge/agents-MCP%20server-F7C948?style=flat-square&labelColor=0A1D1A"></p>67js is a WebGL2 renderer with addons for terrain, vegetation, characters, liquid, vehicles and media export.A scene is plain data: each part has a geometry, a matrix and a material.An agent builds and changes a scene through an MCP server, looks at PNG previews and renders stills or MP4 video.The goal is to be as capable as Blender and as light as three.js. [Issue #23](https://github.com/codepawl/67.js/issues/23) tracks the work.+See the [showcase](https://67js.codepawl.com/showcase.html), the [documentation](https://67js.codepawl.com/docs.html), the [guide for agents](https://67js.codepawl.com/llms.txt) and the [changelog](https://github.com/codepawl/67.js/blob/main/CHANGELOG.md).++## Showcase++Each picture below is a 67js render. The linked ones open live in the browser.<table><tr>- <td width="50%"><img src="https://67js.codepawl.com/previews/bistro-cafe.webp" alt="A green corner restaurant with red awnings and a blue scooter in the Bistro scene, rendered by 67js" /><br /><b>Bistro cafe corner</b></td>- <td width="50%"><img src="https://67js.codepawl.com/previews/bistro-plaza.webp" alt="A large plane tree in a hedged circle on a Bistro plaza, rendered by 67js" /><br /><b>Bistro plaza</b></td>+ <td width="33%" valign="top"><b>Bistro cafe corner</b></td>+ <td width="33%" valign="top"><b>Bistro plaza</b></td>+ <td width="33%" valign="top"><b><a href="https://67js.codepawl.com/showcase.html?scene=port">Container port</a></b></td></tr>-</table>--<table><tr>- <td width="33%"><a href="https://67js.codepawl.com/showcase.html?scene=airport"><img src="https://67js.codepawl.com/previews/showcase-airport.webp" alt="An airport ramp with an airliner at its stand and the turnaround crew, rendered by 67js" /></a><br /><b>Airport ramp</b></td>- <td width="33%"><a href="https://67js.codepawl.com/showcase.html?scene=datacenter"><img src="https://67js.codepawl.com/previews/showcase-datacenter.webp" alt="A cutaway AI data center hall rendered by 67js" /></a><br /><b>AI data center</b></td>- <td width="33%"><a href="https://67js.codepawl.com/showcase.html?scene=port"><img src="https://67js.codepawl.com/previews/showcase-port.webp" alt="A container port with cranes and stacked containers rendered by 67js" /></a><br /><b>Container port</b></td>+ <td><img src="https://67js.codepawl.com/previews/bistro-cafe.webp" alt="A green corner restaurant with red awnings and a blue scooter in the Bistro scene"></td>+ <td><img src="https://67js.codepawl.com/previews/bistro-plaza.webp" alt="A large plane tree in a hedged circle on a Bistro plaza"></td>+ <td><a href="https://67js.codepawl.com/showcase.html?scene=port"><img src="https://67js.codepawl.com/previews/showcase-port.webp" alt="A container port with cranes and stacked containers"></a></td></tr></table>+The [airport ramp](https://67js.codepawl.com/showcase.html?scene=airport) and the [AI data center](https://67js.codepawl.com/showcase.html?scene=datacenter) in the banner open live too.+## Install+**Let your agent do it.** Paste this prompt into Claude Code, Codex, Cursor, Gemini CLI or OpenCode. The agent installs+the package, reads the guide and connects the MCP server.++```text+Install 67js from npm as `67js@npm:@codepawlhq/67js` and connect its MCP server with `npx 67js-mcp`. Read+https://67js.codepawl.com/llms.txt first and follow it.+```++**By hand**+```shnpm install 67js@npm:@codepawlhq/67js```@@ -162,5 +160,8 @@ Read [CONTRIBUTING.md](https://github.com/codepawl/67.js/blob/main/CONTRIBUTING.- The textures and the HDRI on the site are CC0 scans from [Poly Haven](https://polyhaven.com) and [ambientCG](https://ambientcg.com). See [the texture credits](https://github.com/codepawl/67.js/blob/main/public/textures/CREDITS.md).- The Bistro renders use [Amazon Lumberyard Bistro](https://developer.nvidia.com/orca/amazon-lumberyard-bistro) (CC BY 4.0, from the NVIDIA ORCA library) under a CC0 [Poly Haven](https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky) sky.- The showcase models and their sources are listed in each world's `scene.json` under `public/showcase/`.+- The banner wordmark uses [Sora](https://fonts.google.com/specimen/Sora) (SIL Open Font License).++## License[MIT](LICENSE) © CodePawldiff --git a/changes/readme-house-style.md b/changes/readme-house-style.mdnew file mode 100644index 00000000..9e553868--- /dev/null+++ b/changes/readme-house-style.md@@ -0,0 +1 @@+- The README follows the same layout as the other CodePawl repos: a banner with the wordmark and three renders, flat-square badges, a showcase table, an install section that starts with a prompt to paste into an agent, and a License heading.diff --git a/public/previews/banner.jpg b/public/previews/banner.jpgnew file mode 100644index 00000000..e574fdb3Binary files /dev/null and b/public/previews/banner.jpg differdiff --git a/public/previews/bistro-street.webp b/public/previews/bistro-street.webpdeleted file mode 100644index b98fd0d7..00000000Binary files a/public/previews/bistro-street.webp and /dev/null differ