Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

16.7 KB
Raw Blame
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
<title>3D AR Studio: put anything in your room</title>
<meta name="description" content="A complete augmented-reality studio for any web page: place any number of 3D models in your real space through the camera, generate new ones from a prompt, share the scene as a link, and build together live." />
<meta property="og:type" content="website" />
<meta property="og:title" content="3D AR Studio: put anything in your room" />
<meta property="og:description" content="A complete augmented-reality studio for any web page: place any number of 3D models in your real space through the camera, generate new ones from a prompt, share the scene as a link, and build together live." />
<meta name="twitter:card" content="summary_large_image" />
<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%238b7cf8'/%3E%3Cpath d='M16 6l9 5.2v10.4L16 27l-9-5.4V11.2z' fill='none' stroke='%23fff' stroke-width='2' stroke-linejoin='round'/%3E%3C/svg%3E" />
<style>
:root {
	color-scheme: dark;
	--bg: #07080c;
	--panel: rgba(255, 255, 255, 0.04);
	--line: rgba(255, 255, 255, 0.1);
	--ink: #ecedf2;
	--dim: #9aa0af;
	--faint: #6b7080;
	--accent: #8b7cf8;
	--accent-ink: #dcd6ff;
	--radius: 16px;
	--font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
	--mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
}
* { box-sizing: border-box; }
html { scroll-behavior: smooth; }
body {
	margin: 0;
	font-family: var(--font);
	background: radial-gradient(120% 90% at 50% 0%, #141827 0%, #0a0b11 45%, #06070a 100%);
	color: var(--ink);
	line-height: 1.6;
	-webkit-font-smoothing: antialiased;
}
a { color: var(--accent-ink); }
.wrap { max-width: 1040px; margin: 0 auto; padding: 0 20px; }
header.site {
	position: sticky; top: 0; z-index: 50;
	backdrop-filter: blur(12px);
	background: rgba(7, 8, 12, 0.72);
	border-bottom: 1px solid var(--line);
}
header.site .wrap { display: flex; align-items: center; gap: 16px; height: 60px; }
.brand { display: flex; align-items: center; gap: 9px; font-weight: 750; letter-spacing: -0.01em; text-decoration: none; color: var(--ink); }
.brand .dot { width: 10px; height: 10px; border-radius: 3px; background: linear-gradient(135deg, var(--accent), #4fd1c5); box-shadow: 0 0 18px rgba(139, 124, 248, 0.7); }
nav.site { margin-left: auto; display: flex; gap: 6px; align-items: center; flex-wrap: wrap; }
nav.site a {
	color: var(--dim); text-decoration: none; font-size: 14px; font-weight: 600;
	padding: 7px 11px; border-radius: 9px; transition: color .15s, background .15s;
}
nav.site a:hover, nav.site a[aria-current="page"] { color: var(--ink); background: rgba(255, 255, 255, 0.07); }
h1, h2, h3 { line-height: 1.2; letter-spacing: -0.02em; margin: 0 0 12px; }
h1 { font-size: clamp(34px, 6vw, 56px); font-weight: 800; }
h2 { font-size: clamp(23px, 3.4vw, 31px); font-weight: 750; margin-top: 8px; }
h3 { font-size: 17px; font-weight: 700; }
p { margin: 0 0 14px; color: var(--dim); }
p.lead { font-size: clamp(16px, 2.1vw, 19px); color: #c3c8d4; max-width: 62ch; }
section { padding: 56px 0; border-top: 1px solid var(--line); }
section:first-of-type { border-top: 0; }
.eyebrow { font-size: 12px; font-weight: 750; letter-spacing: 0.14em; text-transform: uppercase; color: var(--accent); margin-bottom: 12px; }
.row { display: flex; gap: 12px; flex-wrap: wrap; align-items: center; }
.btn {
	display: inline-flex; align-items: center; gap: 8px; text-decoration: none;
	font-size: 15px; font-weight: 700; padding: 12px 20px; border-radius: 12px;
	background: rgba(255, 255, 255, 0.06); border: 1px solid var(--line); color: var(--ink);
	transition: background .15s, border-color .15s, transform .06s;
	cursor: pointer;
}
.btn:hover { background: rgba(255, 255, 255, 0.11); border-color: rgba(255, 255, 255, 0.24); }
.btn:active { transform: translateY(1px); }
.btn.primary { background: var(--accent); border-color: var(--accent); color: #0d0b1e; }
.btn.primary:hover { filter: brightness(1.08); }
.grid { display: grid; gap: 14px; grid-template-columns: repeat(auto-fit, minmax(232px, 1fr)); }
.card {
	background: var(--panel); border: 1px solid var(--line); border-radius: var(--radius);
	padding: 18px 18px 16px;
}
.card h3 { margin-bottom: 6px; }
.card p { font-size: 14px; margin: 0; }
.card .ico { font-size: 22px; line-height: 1; margin-bottom: 10px; display: block; }
pre {
	margin: 0 0 14px; padding: 16px 18px; overflow-x: auto;
	background: #0b0d13; border: 1px solid var(--line); border-radius: 13px;
	font-family: var(--mono); font-size: 13.5px; line-height: 1.65; color: #d7dbe6;
}
code { font-family: var(--mono); font-size: 0.92em; }
p code, li code, td code { background: rgba(255, 255, 255, 0.07); padding: 1.5px 6px; border-radius: 6px; color: var(--accent-ink); }
table { width: 100%; border-collapse: collapse; font-size: 14px; margin-bottom: 16px; display: block; overflow-x: auto; }
th, td { text-align: left; padding: 10px 12px; border-bottom: 1px solid var(--line); vertical-align: top; }
th { color: var(--ink); font-weight: 700; white-space: nowrap; }
td { color: var(--dim); }
ul { color: var(--dim); padding-left: 22px; }
li { margin-bottom: 7px; }
.stage {
	position: relative; height: min(72vh, 620px); min-height: 420px;
	border: 1px solid var(--line); border-radius: 18px; overflow: hidden;
	background: #06070a; box-shadow: 0 30px 80px -40px rgba(139, 124, 248, 0.5);
}
.pill {
	display: inline-flex; align-items: center; gap: 7px; font-size: 12.5px; font-weight: 650;
	color: var(--accent-ink); background: rgba(139, 124, 248, 0.14);
	border: 1px solid rgba(139, 124, 248, 0.38); border-radius: 999px; padding: 6px 13px;
	margin-bottom: 18px;
}
footer.site { border-top: 1px solid var(--line); padding: 34px 0 60px; color: var(--faint); font-size: 13.5px; }
footer.site a { color: var(--dim); }
.tabs { display: flex; gap: 6px; margin-bottom: 12px; flex-wrap: wrap; }
.tab {
	appearance: none; cursor: pointer; font: inherit; font-size: 13px; font-weight: 650;
	color: var(--dim); background: rgba(255, 255, 255, 0.05); border: 1px solid transparent;
	border-radius: 999px; padding: 7px 14px;
}
.tab[aria-selected="true"] { color: var(--accent-ink); background: rgba(139, 124, 248, 0.16); border-color: rgba(139, 124, 248, 0.4); }
[hidden] { display: none !important; }
@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }
</style>
<script type="module" src="./ar-studio.min.js"></script>
</head>
<body>

<header class="site"><div class="wrap">
	<a class="brand" href="./index.html"><span class="dot" aria-hidden="true"></span> 3D AR Studio</a>
	<nav class="site">
		<a href="./index.html" aria-current="page">Overview</a>
		<a href="./studio.html">Live demo</a>
		<a href="./mcp.html">MCP server</a>
		<a href="https://github.com/nirholas/3D-AR-Studio">GitHub</a>
		<a href="https://www.npmjs.com/package/3d-ar-studio">npm</a>
	</nav>
</div></header>

<section class="wrap" style="padding-top:56px">
	<span class="pill">Apache-2.0 · one script tag · works on iPhone and Android</span>
	<h1>Put anything in your room.</h1>
	<p class="lead">
		A complete augmented-reality studio you can drop into any web page. Place as many 3D models
		as you like in your real space through the camera, describe a new one and watch it appear,
		arrange everything by hand, then share the whole scene as a link, a QR code, or a live room
		someone else can build in with you.
	</p>
	<div class="row" style="margin:22px 0 30px">
		<a class="btn primary" href="./studio.html">Open the live demo</a>
		<a class="btn" href="#quickstart">Add it to your site</a>
		<a class="btn" href="https://github.com/nirholas/3D-AR-Studio">Star on GitHub</a>
	</div>
	<div class="stage"><ar-studio embedded style="position:absolute;inset:0;min-height:0"
		title="Live demo" share-base="https://nirholas.github.io/3D-AR-Studio/studio.html"></ar-studio></div>
	<p style="font-size:13px;color:var(--faint);margin-top:12px">
		That frame is the real package, running the same code you install. On a phone, tap
		<strong>Place in your space</strong> and the model is anchored to your actual floor by
		ARKit or ARCore. <strong>Camera</strong> is the in-page preview beside it: it turns with
		the phone, it does not track the room.
	</p>
</section>

<section class="wrap" id="quickstart">
	<div class="eyebrow">Quick start</div>
	<h2>One line, and you have AR.</h2>
	<p class="lead">No build step, no API key, no account. The models and the text-to-3D lane are free and keyless.</p>
	<h3>Plain HTML</h3>
<pre><code>&lt;script type="module" src="https://unpkg.com/3d-ar-studio/dist/ar-studio.min.js"&gt;&lt;/script&gt;
&lt;ar-studio&gt;&lt;/ar-studio&gt;</code></pre>
	<h3>npm</h3>
<pre><code>npm i 3d-ar-studio three</code></pre>
<pre><code>import { createArStudio } from '3d-ar-studio'

const studio = createArStudio('#stage', {
  assets: 'https://your.cdn/models.json',   // your catalogue, or leave it out for the free CC0 library
  branding: { title: 'Acme AR', accent: '#00b894' },
})

studio.on('add', ({ placement }) =&gt; console.log('placed', placement.title))</code></pre>
	<h3>Scaffold a deployable page</h3>
<pre><code>npx 3d-ar-studio create my-ar-site      # a ready-to-publish folder
npx 3d-ar-studio deploy                 # push it and turn on GitHub Pages</code></pre>
</section>

<section class="wrap">
	<div class="eyebrow">What you get</div>
	<h2>Not a model viewer. A studio.</h2>
	<div class="grid">
		<div class="card"><span class="ico" aria-hidden="true">🏠</span>
			<h3>Many models, one room</h3>
			<p>Place, drag, pinch-resize, twist-rotate and duplicate as many models as you want in a single live camera view. Every other web-AR drop-in stops at one.</p></div>
		<div class="card"><span class="ico" aria-hidden="true">✍️</span>
			<h3>Generate without leaving the camera</h3>
			<p>Type "a brass desk lamp" into the dock. The generation runs behind the live view and the finished model drops into the room. Free, keyless, no account.</p></div>
		<div class="card"><span class="ico" aria-hidden="true">✦</span>
			<h3>Real WebXR, not a fallback</h3>
			<p>An always-armed hit-test reticle, one XRAnchor per model, real-world light estimation, and depth occlusion so models hide behind your furniture.</p></div>
		<div class="card"><span class="ico" aria-hidden="true">📱</span>
			<h3>Real ARKit on iPhone, not an approximation</h3>
			<p>Tap <strong>Place in your space</strong> and Apple's own "View in AR" sheet opens: true plane detection, true scale, true occlusion. The model is converted to USDZ on the device, stood on the floor rather than left at the height it was modelled at, and prepared before the tap, because iOS opens Quick Look only while the gesture is still live. Android without WebXR gets Scene Viewer.</p></div>
		<div class="card"><span class="ico" aria-hidden="true">🔗</span>
			<h3>Scenes are links</h3>
			<p>The whole arrangement (models, positions, rotations, scales) round-trips through the URL. Compose on a laptop, scan the QR, it reopens exactly on your phone.</p></div>
		<div class="card"><span class="ico" aria-hidden="true">👥</span>
			<h3>Build together, live</h3>
			<p>Open a room, share a six-character code, and every add and move syncs to everyone in it in real time, with live presence.</p></div>
		<div class="card"><span class="ico" aria-hidden="true">🕺</span>
			<h3>Characters actually move</h3>
			<p>Any humanoid GLB with no baked animation gets an idle clip retargeted onto its own skeleton: Mixamo, VRM, Avaturn, Unreal, Daz. No rig allow-list, no T-poses.</p></div>
		<div class="card"><span class="ico" aria-hidden="true">🤖</span>
			<h3>Agents can drive it</h3>
			<p>A bundled MCP server lets Claude, ChatGPT or any agent generate a model, compose an arrangement, and hand your user one link that opens it in their room.</p></div>
	</div>
</section>

<section class="wrap" id="assets">
	<div class="eyebrow">Your models</div>
	<h2>Bring your own catalogue.</h2>
	<p class="lead">
		Out of the box the tray is filled from three.ws: a few hundred public-domain (CC0) props,
		free for commercial use, served with open CORS. Swap in your own with one option
		a URL, an array, or a function.
	</p>
<pre><code>// 1. A JSON file anywhere. Five common shapes are read without reshaping.
createArStudio(el, { assets: 'https://cdn.acme.com/models.json' })

// 2. A list you hold in code.
import { staticSource } from '3d-ar-studio/sources'
createArStudio(el, { assets: staticSource({
  label: 'Our furniture',
  items: [{ src: 'https://cdn.acme.com/chair.glb', title: 'Aero chair', poster: '…' }],
}) })

// 3. Several tabs at once, in order.
createArStudio(el, { assets: ['recent', myCatalogue, 'objects', 'link'] })

// 4. Anything else: a source is just an object with a list().
createArStudio(el, { assets: {
  id: 'search', label: 'Search', searchable: true,
  async list() {
    const r = await fetch('/api/models').then((x) =&gt; x.json())
    return r.map((m) =&gt; ({ src: m.glb, title: m.name, poster: m.thumb }))
  },
} })</code></pre>
	<p>Your users can also point the studio somewhere else themselves, without touching your code:
	add <code>?assets=https://…/manifest.json</code> to the page URL. Only https URLs are accepted, and every
	model source is re-validated before it reaches the loader.</p>
</section>

<section class="wrap" id="options">
	<div class="eyebrow">Configuration</div>
	<h2>Options</h2>
	<table>
		<thead><tr><th>Option</th><th>Default</th><th>What it does</th></tr></thead>
		<tbody>
			<tr><td><code>assets</code></td><td><code>'three.ws'</code></td><td>Where models come from: a preset, a manifest URL, a source object, or an array of them.</td></tr>
			<tr><td><code>generate</code></td><td>enabled, free three.ws lane</td><td><code>{ enabled, endpoint, kind, tier }</code>. <code>endpoint</code> is any MCP server exposing a compatible generate tool.</td></tr>
			<tr><td><code>rooms</code></td><td>enabled</td><td><code>{ enabled, server }</code>. Point <code>server</code> at your own Colyseus deployment to host shared rooms yourself.</td></tr>
			<tr><td><code>animations</code></td><td>three.ws idle clip</td><td><code>{ enabled, manifestUrl, clip }</code>. The clip retargeted onto humanoid models that ship no animation.</td></tr>
			<tr><td><code>lighting</code></td><td><code>'studio'</code> HDRI</td><td><code>{ preset, urls }</code>. Set <code>preset: null</code> for procedural lighting only and zero HDRI download.</td></tr>
			<tr><td><code>branding</code></td><td> </td><td><code>{ title, accent, backHref, backLabel }</code>.</td></tr>
			<tr><td><code>shareBaseUrl</code></td><td>this page</td><td>Where share links and QR codes point.</td></tr>
			<tr><td><code>persistKey</code></td><td><code>'ar-studio:scene:v1'</code></td><td>localStorage key for the saved scene. Change it to run two studios on one origin.</td></tr>
			<tr><td><code>maxPlacements</code></td><td><code>20</code></td><td>Cap on simultaneous models. Keeps low-end phones interactive.</td></tr>
			<tr><td><code>allowUrlOverride</code></td><td><code>true</code></td><td>Honour <code>?assets=</code>, <code>?src=</code>, <code>?room=</code> and <code>?forge=</code> on the hosting page's URL.</td></tr>
			<tr><td><code>onEvent</code></td><td><code>null</code></td><td>Called with <code>(event, detail)</code> for every notable action: wire it to your analytics.</td></tr>
		</tbody>
	</table>
	<h3>Events</h3>
	<p>Subscribe with <code>studio.on(name, fn)</code>, or listen for <code>ar-studio:&lt;name&gt;</code> DOM events on the mounted element:
	<code>add</code>, <code>remove</code>, <code>select</code>, <code>clear</code>, <code>generate</code>,
	<code>generate-error</code>, <code>camera</code>, <code>xr</code>, <code>room</code>, <code>share</code>.</p>
</section>

<section class="wrap">
	<div class="eyebrow">Provenance</div>
	<h2>Extracted from a studio people already use.</h2>
	<p class="lead">
		This is not a demo written to look good in a README. The rendering ladder, the anchor
		lifecycle, the retargeting pipeline, the scene format and the shared-room protocol are
		lifted from the AR surfaces running in production on
		<a href="https://three.ws">three.ws</a>, and generalized so they work on your site
		with your models.
	</p>
</section>


<footer class="site"><div class="wrap">
	<p><strong style="color:var(--ink)">3D AR Studio</strong> is open source under Apache-2.0.
	Models and the free text-to-3D lane are served by <a href="https://three.ws">three.ws</a>; point it at your own catalogue with one option.</p>
	<p><a href="https://github.com/nirholas/3D-AR-Studio">GitHub</a> · <a href="https://www.npmjs.com/package/3d-ar-studio">npm</a> · <a href="https://registry.modelcontextprotocol.io/?q=3d-ar-studio">MCP registry</a> · <a href="https://three.ws">three.ws</a></p>
</div></footer>
</body>
</html>