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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
<!DOCTYPE html>
<html lang="en">
<head>
<script>/* three.ws theme boot — no-flash; runtime in /theme-switcher.js */(function(){try{var m=localStorage.getItem('twx_theme');var l=m==='auto'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: light)').matches):m==='light';document.documentElement.setAttribute('data-theme',l?'light':'dark');}catch(e){document.documentElement.setAttribute('data-theme','dark');}})();</script>
<meta charset="UTF-8" />
<link rel="icon" href="/favicon.ico" sizes="any" />
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png" />
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
<link rel="manifest" href="/manifest.webmanifest" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title data-i18n="segment.meta_title">Parts Studio · Segment a 3D model · three.ws</title>
<meta
name="description"
content="Split any 3D model into meaningful, separable parts — head, torso, limbs; body, wheels, glass. Click a part to isolate it, toggle visibility, and export it on its own as GLB."
data-i18n-attr="content:segment.meta_description"/>
<meta property="og:title" content="Parts Studio — Segment a 3D model · three.ws" data-i18n-attr="content:segment.meta_og_title"/>
<meta
property="og:description"
content="Turn a single mesh into addressable, named parts you can hide, recolour, replace, and export individually."
data-i18n-attr="content:segment.meta_og_description"/>
<meta property="og:type" content="website" />
<meta property="og:site_name" content="three.ws" />
<meta property="og:url" content="https://three.ws/segment" />
<meta property="og:image" content="https://three.ws/og-image.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@trythreews" />
<meta name="twitter:title" content="Parts Studio · Segment a 3D model · three.ws" data-i18n-attr="content:segment.meta_twitter_title"/>
<meta name="twitter:description" content="Segment and isolate parts of any 3D model. Extract, label, and export components for use in your avatar or world." data-i18n-attr="content:segment.meta_twitter_description"/>
<meta name="twitter:image" content="https://three.ws/og-image.png" />
<link rel="stylesheet" href="/style.css" />
<style>
.seg-main {
max-width: 1280px;
margin: 0 auto;
padding: var(--space-xl) var(--space-md) var(--space-2xl);
}
.seg-head {
/* Reset the global site-nav `header` rule from style.css —
this is an in-page hero, not the top bar. */
display: block;
height: auto;
padding: 0;
background: none;
backdrop-filter: none;
-webkit-backdrop-filter: none;
border-bottom: 0;
overflow: visible;
white-space: normal;
line-height: var(--leading-normal);
z-index: auto;
-webkit-app-region: no-drag;
text-align: center;
margin-bottom: var(--space-lg);
}
.seg-eyebrow {
display: inline-flex;
align-items: center;
gap: 0.45rem;
font-family: var(--font-mono);
font-size: var(--text-xs);
letter-spacing: 0.16em;
text-transform: uppercase;
color: var(--ink-dim);
border: 1px solid var(--stroke);
border-radius: 999px;
padding: 0.3rem 0.7rem;
}
.seg-eyebrow::before {
content: '';
width: 6px;
height: 6px;
border-radius: 50%;
background: var(--success);
box-shadow: 0 0 8px var(--success);
}
.seg-head h1 {
display: block;
color: var(--ink);
font-family: var(--font-display);
font-size: clamp(2rem, 5vw, var(--text-2xl));
line-height: var(--leading-tight);
margin: var(--space-md) 0 var(--space-xs);
}
.seg-head p {
color: var(--ink-dim);
max-width: 52ch;
margin: 0 auto;
line-height: var(--leading-normal);
}
/* Composer ----------------------------------------------------- */
.composer {
background: var(--surface-glass);
border: 1px solid var(--stroke-strong);
border-radius: var(--radius-lg);
padding: var(--space-md);
box-shadow: 0 24px 60px -30px rgba(0, 0, 0, 0.8);
display: grid;
grid-template-columns: 1fr auto auto auto;
gap: var(--space-sm);
align-items: end;
}
@media (max-width: 760px) {
.composer {
grid-template-columns: 1fr 1fr;
}
.composer .field-url {
grid-column: 1 / -1;
}
.composer .btn {
grid-column: 1 / -1;
justify-content: center;
}
}
.field {
display: flex;
flex-direction: column;
gap: 0.3rem;
min-width: 0;
}
.field label {
font-family: var(--font-mono);
font-size: var(--text-xs);
letter-spacing: 0.08em;
text-transform: uppercase;
color: var(--ink-dim);
}
.field input,
.field select {
background: var(--surface-1);
border: 1px solid var(--stroke);
border-radius: var(--radius-md);
color: var(--ink);
font-family: var(--font-body);
font-size: var(--text-base);
padding: 0.6rem 0.7rem;
outline: none;
transition: border-color var(--duration-fast), box-shadow var(--duration-fast);
}
.field input:focus,
.field select:focus {
border-color: var(--accent);
box-shadow: 0 0 0 3px var(--accent-soft);
}
.field input[type='number'] {
width: 6.5rem;
}
.btn {
display: inline-flex;
align-items: center;
gap: 0.5rem;
font-family: var(--font-display);
font-weight: 600;
font-size: var(--text-base);
color: #0b0b0b;
background: var(--accent);
border: 1px solid var(--accent);
border-radius: var(--radius-md);
padding: 0.62rem 1.2rem;
cursor: pointer;
transition: transform var(--duration-fast) var(--ease-standard), opacity var(--duration-fast), box-shadow var(--duration-fast);
}
.btn:hover {
box-shadow: 0 0 0 4px var(--accent-soft);
}
.btn:active {
transform: translateY(1px);
}
.btn[disabled] {
opacity: 0.45;
cursor: not-allowed;
}
.btn-ghost {
background: transparent;
color: var(--ink);
border: 1px solid var(--stroke-strong);
}
.btn-ghost:hover {
background: var(--surface-2);
box-shadow: none;
}
.btn:focus-visible,
.icon-btn:focus-visible {
outline: 2px solid var(--accent);
outline-offset: 2px;
}
/* Stage / states ---------------------------------------------- */
.stage {
margin-top: var(--space-lg);
min-height: 360px;
}
.panel {
background: var(--surface-glass);
border: 1px solid var(--stroke);
border-radius: var(--radius-lg);
overflow: hidden;
}
.is-hidden {
display: none !important;
}
/* Loading */
.loading {
display: grid;
place-items: center;
padding: var(--space-2xl);
text-align: center;
}
.loading .spinner {
width: 38px;
height: 38px;
border-radius: 50%;
border: 3px solid var(--stroke-strong);
border-top-color: var(--accent);
animation: spin 0.8s linear infinite;
margin-bottom: var(--space-md);
}
@keyframes spin {
to {
transform: rotate(360deg);
}
}
.loading h3 {
font-family: var(--font-display);
margin: 0 0 var(--space-xs);
}
.loading p {
color: var(--ink-dim);
margin: 0;
}
.loading .meta {
font-family: var(--font-mono);
font-size: var(--text-xs);
color: var(--ink-dim);
margin-top: var(--space-sm);
}
/* Result layout: viewport + parts panel */
.result {
display: grid;
grid-template-columns: 1fr 320px;
min-height: min(70vh, 640px);
}
@media (max-width: 880px) {
.result {
grid-template-columns: 1fr;
}
}
.viewport-wrap {
position: relative;
background: radial-gradient(120% 120% at 50% 0%, #161616 0%, #0b0b0b 70%);
min-height: 360px;
}
.viewport {
position: absolute;
inset: 0;
}
.viewport-bar {
position: absolute;
left: 0;
right: 0;
bottom: 0;
display: flex;
align-items: center;
justify-content: space-between;
gap: var(--space-sm);
padding: var(--space-sm) var(--space-md);
background: linear-gradient(to top, rgba(0, 0, 0, 0.6), transparent);
flex-wrap: wrap;
}
.viewport-bar .label {
font-size: var(--text-sm);
color: var(--ink);
font-family: var(--font-mono);
}
.viewport-bar .actions {
display: inline-flex;
gap: var(--space-xs);
}
.tip {
position: absolute;
top: var(--space-sm);
left: var(--space-md);
font-family: var(--font-mono);
font-size: var(--text-xs);
color: var(--ink-dim);
background: rgba(0, 0, 0, 0.4);
padding: 0.25rem 0.55rem;
border-radius: 999px;
pointer-events: none;
}
/* Parts panel */
.parts {
border-left: 1px solid var(--stroke);
display: flex;
flex-direction: column;
min-height: 0;
background: var(--surface-1);
}
@media (max-width: 880px) {
.parts {
border-left: none;
border-top: 1px solid var(--stroke);
}
}
.parts-head {
display: flex;
align-items: center;
justify-content: space-between;
padding: var(--space-sm) var(--space-md);
border-bottom: 1px solid var(--stroke);
}
.parts-head h2 {
font-family: var(--font-display);
font-size: var(--text-base);
margin: 0;
display: flex;
align-items: center;
gap: 0.5rem;
}
.parts-head .count {
font-family: var(--font-mono);
font-size: var(--text-xs);
color: var(--ink-dim);
background: var(--surface-3);
border-radius: 999px;
padding: 0.1rem 0.5rem;
}
.parts-list {
overflow-y: auto;
max-height: min(60vh, 560px);
padding: var(--space-xs);
display: flex;
flex-direction: column;
gap: 2px;
}
.part-row {
display: flex;
align-items: center;
gap: 0.25rem;
border-radius: var(--radius-md);
padding: 0.15rem 0.25rem;
transition: background var(--duration-fast);
}
.part-row:hover {
background: var(--surface-2);
}
.part-row.is-selected {
background: var(--accent-soft);
box-shadow: inset 0 0 0 1px var(--accent);
}
.part-row.is-hidden-part .part-text {
opacity: 0.4;
}
.part-main {
flex: 1;
min-width: 0;
display: flex;
align-items: center;
gap: 0.6rem;
background: transparent;
border: none;
color: inherit;
font: inherit;
cursor: pointer;
text-align: left;
padding: 0.4rem 0.4rem;
border-radius: var(--radius-sm);
}
.swatch {
width: 14px;
height: 14px;
border-radius: 4px;
flex: none;
box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.2);
}
.part-text {
min-width: 0;
display: flex;
flex-direction: column;
line-height: 1.25;
}
.part-name {
font-size: var(--text-sm);
color: var(--ink);
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.part-sub {
font-family: var(--font-mono);
font-size: 0.66rem;
color: var(--ink-dim);
}
.part-actions {
display: inline-flex;
gap: 1px;
flex: none;
}
.icon-btn {
background: transparent;
border: none;
color: var(--ink-dim);
font-size: 0.85rem;
width: 26px;
height: 26px;
border-radius: var(--radius-sm);
cursor: pointer;
transition: background var(--duration-fast), color var(--duration-fast);
}
.icon-btn:hover {
background: var(--surface-3);
color: var(--ink);
}
/* Notices (empty/error/unconfigured) */
.notice {
padding: var(--space-2xl) var(--space-lg);
text-align: center;
color: var(--ink-dim);
}
.notice h3 {
color: var(--ink);
font-family: var(--font-display);
margin: 0 0 var(--space-xs);
}
.notice.error h3 {
color: var(--danger);
}
.notice p {
max-width: 52ch;
margin: 0 auto;
line-height: var(--leading-normal);
}
.notice .glyph {
font-size: 2.4rem;
opacity: 0.5;
display: block;
margin-bottom: var(--space-sm);
}
.notice .actions {
margin-top: var(--space-md);
display: inline-flex;
gap: var(--space-xs);
}
.notice code {
font-family: var(--font-mono);
font-size: 0.85em;
background: var(--surface-2);
padding: 0.1rem 0.35rem;
border-radius: var(--radius-sm);
}
.hint-foot {
text-align: center;
color: var(--ink-dim);
font-size: var(--text-xs);
margin-top: var(--space-lg);
line-height: var(--leading-normal);
}
.hint-foot a {
color: var(--ink);
}
</style>
</head>
<body>
<div id="nav-container"></div>
<main class="seg-main">
<header class="seg-head">
<span class="seg-eyebrow" data-i18n="segment.parts_segmentation">Parts · segmentation</span>
<h1 data-i18n="segment.split_a_model_into_parts">Split a model into parts</h1>
<p data-i18n="segment.paste_a_glb_obj_stl_ply_url">
Paste a GLB/OBJ/STL/PLY URL. Parts Studio separates it at disconnected shells and
concave creases into named, recolourable parts — then click any part to isolate it,
toggle its visibility, or export it on its own.
</p>
</header>
<form class="composer" id="composer" autocomplete="off">
<div class="field field-url">
<label for="mesh-url" data-i18n="segment.mesh_url_https">Mesh URL (https)</label>
<input
id="mesh-url"
name="mesh-url"
type="url"
inputmode="url"
placeholder="https://…/model.glb"
required
/>
</div>
<div class="field">
<label for="method" data-i18n="segment.method">Method</label>
<select id="method" name="method">
<option value="auto" selected data-i18n="segment.auto_shells_creases">Auto (shells + creases)</option>
<option value="connected" data-i18n="segment.connected_shells">Connected shells</option>
<option value="crease" data-i18n="segment.concave_creases">Concave creases</option>
</select>
</div>
<div class="field">
<label for="max-parts" data-i18n="segment.max_parts">Max parts</label>
<input id="max-parts" name="max-parts" type="number" min="2" max="64" value="24" />
</div>
<button class="btn" id="segment-btn" type="submit" data-i18n-html="segment.segment">
<span id="segment-label">Segment</span>
</button>
</form>
<section class="stage" id="stage" aria-live="polite">
<!-- Empty -->
<div class="panel notice" id="state-empty">
<span class="glyph" aria-hidden="true">⬢</span>
<h3 data-i18n="segment.nothing_segmented_yet">Nothing segmented yet</h3>
<p data-i18n-html="segment.paste_a_public_mesh_url_above_and">
Paste a public mesh URL above and press Segment. Generated a model in
<a href="/forge">Forge</a>? Open it here with the “Split into parts” button on the
result, or paste its GLB link.
</p>
</div>
<!-- Loading -->
<div class="panel loading is-hidden" id="state-loading">
<div class="spinner" aria-hidden="true"></div>
<h3 data-i18n="segment.segmenting_your_model">Segmenting your model</h3>
<p id="loading-note" data-i18n="segment.fetching_and_analysing_the_mesh">Fetching and analysing the mesh…</p>
<div class="meta" id="loading-meta">Elapsed 0s</div>
<div style="margin-top: var(--space-md)">
<button class="btn btn-ghost" type="button" id="cancel" data-i18n="segment.cancel">Cancel</button>
</div>
</div>
<!-- Result -->
<div class="panel result is-hidden" id="state-result">
<div class="viewport-wrap">
<div class="viewport" id="viewport"></div>
<span class="tip" aria-hidden="true" data-i18n="segment.drag_to_orbit_click_a_part_to">Drag to orbit · click a part to select</span>
<div class="viewport-bar">
<span class="label" id="selection-label" data-i18n="segment.click_a_part_to_inspect">click a part to inspect</span>
<div class="actions">
<button class="btn btn-ghost" type="button" id="reset-view" data-i18n="segment.reset_view">Reset view</button>
<button class="btn btn-ghost" type="button" id="show-all" data-i18n="segment.show_all">Show all</button>
<a class="btn btn-ghost" id="download-glb" download data-i18n="segment.download_glb">Download GLB</a>
</div>
</div>
</div>
<aside class="parts" aria-label="Parts">
<div class="parts-head">
<h2 data-i18n-html="segment.parts_0">Parts <span class="count" id="parts-count">0</span></h2>
</div>
<div class="parts-list" id="parts-list" role="list"></div>
</aside>
</div>
<!-- Error -->
<div class="panel notice error is-hidden" id="state-error">
<span class="glyph" aria-hidden="true">⚠</span>
<h3 data-i18n="segment.segmentation_failed">Segmentation failed</h3>
<p id="error-message" data-i18n="segment.something_went_wrong_try_a_simpler_mesh">Something went wrong. Try a simpler mesh or fewer parts.</p>
<div class="actions">
<button class="btn" type="button" id="retry" data-i18n="segment.try_again">Try again</button>
</div>
</div>
<!-- Unconfigured -->
<div class="panel notice is-hidden" id="state-unconfigured">
<span class="glyph" aria-hidden="true">◌</span>
<h3 data-i18n="segment.segmenter_not_configured">Segmenter not configured</h3>
<p data-i18n-html="segment.part_segmentation_needs_the_segment_worker_d">
Part segmentation needs the segment worker deployed. Once
<code>GCP_SEGMENT_URL</code> and <code>GCP_RECONSTRUCTION_KEY</code> are set, this
page runs the full pipeline with no further changes.
</p>
</div>
</section>
<p class="hint-foot" data-i18n-html="segment.geometry_based_segmentation_disconnected_she">
Geometry-based segmentation — disconnected shells plus the minima rule (cut at concave
creases). Each part becomes a named node in the output GLB. The same tool is available to
agents over MCP as <code>segment_model</code> and over REST at
<a href="/docs">/api/forge-segment</a>.
</p>
</main>
<script src="/nav.js" defer></script>
<script type="module" src="/src/segment.js"></script>
<div id="footer-container"></div>
<script src="/footer.js"></script>
<!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->
<script type="module" src="/i18n.js"></script>
</body>
</html>