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 */(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" />
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
<title data-i18n="tty.page_title">Your agent, in your terminal · three.ws</title>
<meta name="description" content="curl three.ws/tty and a rigged 3D agent walks in your terminal. A real software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, no install. Plus @three-ws/tty-3d, the CLI and SDK that render any GLB in a terminal." data-i18n-attr="content:tty.meta_desc" />
<link rel="canonical" href="https://three.ws/tty" />
<link rel="icon" href="/favicon.ico" sizes="any" />
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
<link rel="manifest" href="/manifest.webmanifest" />
<link rel="stylesheet" href="/style.css" />
<link rel="stylesheet" href="/nav.css" />
<link rel="stylesheet" href="/mobile.css" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Your agent, in your terminal · three.ws" data-i18n-attr="content:tty.share_title" />
<meta property="og:description" content="curl three.ws/tty and a rigged 3D agent walks in your terminal. No GPU, no WebGL, no install." data-i18n-attr="content:tty.share_desc" />
<meta property="og:url" content="https://three.ws/tty" />
<meta property="og:image" content="https://three.ws/api/page-og?s=build&t=Terminal+renderer&d=curl+three.ws%2Ftty+and+a+rigged+3D+agent+walks+in+your+terminal.+A+software+rasterizer+streams+ANSI+frames+over+HTTP%3A+no+GPU%2C+no+WebGL%2C+nothing+to+install.+Also&p=%2Ftty" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Your agent, in your terminal · three.ws" data-i18n-attr="content:tty.share_title" />
<meta name="twitter:description" content="curl three.ws/tty and a rigged 3D agent walks in your terminal. No GPU, no WebGL, no install." data-i18n-attr="content:tty.share_desc" />
<meta name="twitter:image" content="https://three.ws/api/page-og?s=build&t=Terminal+renderer&d=curl+three.ws%2Ftty+and+a+rigged+3D+agent+walks+in+your+terminal.+A+software+rasterizer+streams+ANSI+frames+over+HTTP%3A+no+GPU%2C+no+WebGL%2C+nothing+to+install.+Also&p=%2Ftty" />
<style>
:root {
--tty-bg: #07080c;
--tty-panel: rgba(16, 18, 26, 0.9);
--tty-border: rgba(255, 255, 255, 0.1);
--tty-border-hi: rgba(255, 255, 255, 0.2);
--tty-text: #e9ebf2;
--tty-muted: #8a90a2;
--tty-faint: #5c6273;
--tty-accent: #7ee787;
--tty-accent-2: #8b5cf6;
--tty-screen: #05060a;
}
html, body { background: var(--tty-bg); color: var(--tty-text); margin: 0; }
body { font-family: var(--font-body, 'Inter', system-ui, sans-serif); min-height: 100vh; }
* { box-sizing: border-box; }
.wrap { max-width: 1080px; margin: 0 auto; padding: 0 20px 96px; }
.hero { padding: 72px 0 28px; }
.eyebrow {
display: inline-flex; align-items: center; gap: 8px;
font-size: 12px; letter-spacing: 0.14em; text-transform: uppercase;
color: var(--tty-accent); border: 1px solid rgba(126, 231, 135, 0.28);
border-radius: 999px; padding: 6px 12px; margin-bottom: 20px;
}
h1 { font-size: clamp(30px, 5.4vw, 54px); line-height: 1.05; margin: 0 0 16px; letter-spacing: -0.02em; }
.lede { font-size: clamp(16px, 2.1vw, 19px); color: var(--tty-muted); max-width: 62ch; line-height: 1.6; margin: 0 0 28px; }
.cmd {
display: flex; align-items: center; gap: 12px; flex-wrap: wrap;
background: var(--tty-screen); border: 1px solid var(--tty-border-hi);
border-radius: 12px; padding: 16px 18px; margin: 0 0 14px;
font-family: var(--font-mono, ui-monospace, 'SF Mono', Menlo, monospace);
font-size: clamp(14px, 2.4vw, 20px);
}
.cmd .prompt { color: var(--tty-accent); user-select: none; }
.cmd code { flex: 1 1 auto; min-width: 0; overflow-x: auto; white-space: nowrap; color: var(--tty-text); }
.copy {
flex: 0 0 auto; background: rgba(255, 255, 255, 0.06); color: var(--tty-text);
border: 1px solid var(--tty-border); border-radius: 8px; padding: 8px 14px;
font: inherit; font-size: 13px; cursor: pointer;
transition: background var(--duration-fast) var(--ease-standard), border-color var(--duration-fast) var(--ease-standard), transform var(--duration-fast) var(--ease-standard);
}
.copy:hover { background: rgba(255, 255, 255, 0.12); border-color: var(--tty-border-hi); }
.copy:active { transform: translateY(1px); }
.copy:focus-visible { outline: 2px solid var(--tty-accent); outline-offset: 2px; }
.copy[data-copied="true"] { color: var(--tty-accent); border-color: rgba(126, 231, 135, 0.5); }
.screen-shell {
background: var(--tty-screen); border: 1px solid var(--tty-border);
border-radius: 14px; overflow: hidden; margin: 26px 0 12px;
box-shadow: 0 24px 60px rgba(0, 0, 0, 0.5);
}
.screen-bar {
display: flex; align-items: center; gap: 8px; padding: 10px 14px;
border-bottom: 1px solid var(--tty-border); background: rgba(255, 255, 255, 0.02);
}
.dot { width: 11px; height: 11px; border-radius: 50%; background: #3a3f4d; }
.screen-bar .title {
margin-left: 8px; font-size: 12px; color: var(--tty-faint);
font-family: var(--font-mono, ui-monospace, monospace);
}
.screen-bar .status { margin-left: auto; font-size: 12px; color: var(--tty-faint); }
#screen {
margin: 0; padding: 14px; overflow-x: auto; line-height: 1.0;
font-family: var(--font-mono, ui-monospace, 'SF Mono', Menlo, monospace);
font-size: 11px; letter-spacing: 0; white-space: pre; min-height: 340px;
color: var(--tty-muted);
}
@media (max-width: 720px) { #screen { font-size: 7px; min-height: 240px; } }
.screen-actions { display: flex; gap: 10px; flex-wrap: wrap; margin-bottom: 40px; }
.btn {
background: rgba(255, 255, 255, 0.05); color: var(--tty-text);
border: 1px solid var(--tty-border); border-radius: 8px;
padding: 9px 15px; font: inherit; font-size: 13px; cursor: pointer;
transition: background var(--duration-fast) var(--ease-standard), border-color var(--duration-fast) var(--ease-standard), transform var(--duration-fast) var(--ease-standard);
}
.btn:hover { background: rgba(255, 255, 255, 0.1); border-color: var(--tty-border-hi); }
.btn:active { transform: translateY(1px); }
.btn:focus-visible { outline: 2px solid var(--tty-accent); outline-offset: 2px; }
.btn[aria-pressed="true"] { border-color: var(--tty-accent); color: var(--tty-accent); }
h2 { font-size: clamp(20px, 3vw, 27px); margin: 52px 0 14px; letter-spacing: -0.01em; }
h3 { font-size: 15px; margin: 26px 0 8px; color: var(--tty-text); }
p { color: var(--tty-muted); line-height: 1.65; max-width: 68ch; }
a { color: var(--tty-accent); }
pre.block {
background: var(--tty-screen); border: 1px solid var(--tty-border);
border-radius: 10px; padding: 15px 17px; overflow-x: auto;
font-family: var(--font-mono, ui-monospace, monospace); font-size: 13px;
line-height: 1.6; color: #cdd3e1;
}
.grid { display: grid; gap: 14px; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); margin: 18px 0; }
.card {
background: var(--tty-panel); border: 1px solid var(--tty-border);
border-radius: 12px; padding: 16px 18px;
transition: border-color var(--duration-fast) var(--ease-standard), transform var(--duration-fast) var(--ease-standard);
}
.card:hover { border-color: var(--tty-border-hi); transform: translateY(-2px); }
.card h3 { margin: 0 0 6px; font-size: 14px; }
.card p { margin: 0; font-size: 13.5px; }
table { width: 100%; border-collapse: collapse; margin: 14px 0; font-size: 14px; }
th, td { text-align: left; padding: 9px 12px; border-bottom: 1px solid var(--tty-border); }
th { color: var(--tty-faint); font-weight: 600; font-size: 12px; text-transform: uppercase; letter-spacing: 0.06em; }
td code { color: var(--tty-accent); font-family: var(--font-mono, ui-monospace, monospace); font-size: 13px; }
.note {
border-left: 2px solid var(--tty-accent-2); padding: 2px 0 2px 16px;
margin: 18px 0; color: var(--tty-muted); font-size: 14.5px; line-height: 1.65;
}
footer { margin-top: 64px; padding-top: 26px; border-top: 1px solid var(--tty-border); color: var(--tty-faint); font-size: 13px; }
footer a { margin-right: 18px; }
@media (prefers-reduced-motion: reduce) { .card, .btn, .copy { transition: none; } }
</style>
<meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1">
<meta property="og:site_name" content="three.ws">
<meta property="og:locale" content="en_US">
<meta property="og:image:alt" content="Terminal renderer - three.ws">
<meta name="twitter:site" content="@trythreews">
<script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebPage","name":"Terminal renderer","description":"curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.","url":"https://three.ws/tty","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"},"primaryImageOfPage":"https://three.ws/api/page-og?s=build&t=Terminal+renderer&d=curl+three.ws%2Ftty+and+a+rigged+3D+agent+walks+in+your+terminal.+A+software+rasterizer+streams+ANSI+frames+over+HTTP%3A+no+GPU%2C+no+WebGL%2C+nothing+to+install.+Also&p=%2Ftty"}]}</script>
</head>
<body>
<header class="site-header"><div id="nav-container"></div></header>
<script src="/nav.js"></script>
<main class="wrap">
<section class="hero">
<span class="eyebrow" data-i18n="tty.eyebrow">no gpu · no webgl · no install</span>
<h1 data-i18n="tty.hero_title">Your agent, in your terminal.</h1>
<p class="lede" data-i18n="tty.hero_lede">
One command. A rigged 3D character loads, plays its animation, and turns on a
turntable, drawn entirely out of coloured text. There is nothing to install and
nothing to run: the frames are rasterized on our servers and streamed to your
shell as they are drawn.
</p>
<div class="cmd">
<span class="prompt" aria-hidden="true">$</span>
<code id="curl-cmd">curl three.ws/tty</code>
<button class="copy" type="button" data-copy-target="curl-cmd" data-i18n="tty.copy_btn">Copy</button>
</div>
<p style="font-size:13.5px;margin-top:0" data-i18n="tty.cmd_note">
Works in any terminal that renders colour. Press Ctrl-C to stop it.
</p>
</section>
<section aria-labelledby="demo-heading">
<h2 id="demo-heading" style="margin-top:22px" data-i18n="tty.demo_h">This is the actual output</h2>
<p data-i18n-html="tty.demo_p">
Not a video and not a recording. The panel below opens the same HTTP stream
<code style="color:var(--tty-accent)">curl</code> would, and paints the escape
sequences it receives.
</p>
<div class="screen-shell">
<div class="screen-bar">
<span class="dot" aria-hidden="true"></span>
<span class="dot" aria-hidden="true"></span>
<span class="dot" aria-hidden="true"></span>
<span class="title">curl three.ws/tty</span>
<span class="status" id="stream-status" role="status" aria-live="polite" data-i18n="tty.status_idle">idle</span>
</div>
<pre id="screen" tabindex="0" aria-label="Live terminal render of a 3D agent" data-i18n-attr="aria-label:tty.screen_aria"></pre>
</div>
<div class="screen-actions">
<button class="btn" type="button" id="btn-play" data-i18n="tty.btn_play">Run it</button>
<button class="btn" type="button" id="btn-spin" aria-pressed="true" data-i18n="tty.btn_spin">Turntable</button>
<button class="btn" type="button" id="btn-color" aria-pressed="true" data-i18n="tty.btn_color">Colour</button>
</div>
</section>
<section>
<h2 data-i18n="tty.render_h">Render any model, locally</h2>
<p data-i18n-html="tty.render_p">
The renderer is a published package. It takes a GLB, decodes it (including
<code style="color:var(--tty-accent)">EXT_meshopt_compression</code>, which most
real avatars ship with), evaluates the animation, applies linear blend skinning
on the CPU, and rasterizes with a z-buffer. No GPU is involved at any point, so
it runs the same over SSH, in CI, or in a container with no display.
</p>
<pre class="block"><code># a local file
npx @three-ws/tty-3d ./avatar.glb
# anything on the web
npx @three-ws/tty-3d https://three.ws/avatars/default.glb --spin 1.4
# a still frame, piped somewhere
npx @three-ws/tty-3d avatar.glb --once --width 80 --color mono > frame.txt</code></pre>
<p style="font-size:13.5px" data-i18n-html="tty.render_keys">
Arrow keys orbit, <code style="color:var(--tty-accent)">w</code>/<code style="color:var(--tty-accent)">s</code>
tilt, <code style="color:var(--tty-accent)">+</code>/<code style="color:var(--tty-accent)">-</code> zoom,
space pauses, <code style="color:var(--tty-accent)">q</code> quits.
</p>
<h2 data-i18n="tty.library_h">Or as a library</h2>
<pre class="block"><code>import { loadModel, createRenderer } from '@three-ws/tty-3d';
const model = await loadModel('./avatar.glb');
const renderer = createRenderer(model, { width: 80, height: 40 });
// One string per frame. Write it wherever you like.
process.stdout.write(renderer.frame(1.25));</code></pre>
</section>
<section>
<h2 data-i18n="tty.endpoint_h">The hosted endpoint</h2>
<p data-i18n-html="tty.endpoint_p">
<code style="color:var(--tty-accent)">GET /api/tty</code> streams frames as
<code style="color:var(--tty-accent)">text/plain</code>, paced in real time, so the
response itself is the animation. Every parameter is optional.
</p>
<table>
<thead><tr><th data-i18n="tty.th_param">Parameter</th><th data-i18n="tty.th_meaning">Meaning</th><th data-i18n="tty.th_default">Default</th></tr></thead>
<tbody>
<tr><td><code>avatar</code></td><td data-i18n-html="tty.row_avatar_meaning">A public three.ws avatar id. Also the path form, <code>/tty/<id></code>.</td><td data-i18n="tty.row_avatar_default">the three.ws model</td></tr>
<tr><td><code>src</code></td><td data-i18n="tty.row_src_meaning">Any public GLB URL.</td><td data-i18n="tty.row_src_default">none</td></tr>
<tr><td><code>w</code>, <code>h</code></td><td data-i18n="tty.row_wh_meaning">Columns and rows.</td><td>76 x 30</td></tr>
<tr><td><code>frames</code></td><td data-i18n-html="tty.row_frames_meaning">How many frames to send. <code>1</code> gives a still.</td><td data-i18n="tty.row_frames_default">8 seconds</td></tr>
<tr><td><code>fps</code></td><td data-i18n="tty.row_fps_meaning">Frames per second, 4 to 30.</td><td>18</td></tr>
<tr><td><code>t</code></td><td data-i18n="tty.row_t_meaning">Where in the clip to start, in seconds.</td><td>0</td></tr>
<tr><td><code>spin</code></td><td data-i18n-html="tty.row_spin_meaning">Turntable speed in radians per second. <code>0</code> holds still.</td><td>0.9</td></tr>
<tr><td><code>clip</code></td><td data-i18n="tty.row_clip_meaning">Animation name to play.</td><td data-i18n="tty.row_clip_default">the first clip</td></tr>
<tr><td><code>color</code></td><td data-i18n-html="tty.row_color_meaning"><code>truecolor</code>, <code>ansi256</code>, or <code>mono</code>.</td><td>ansi256</td></tr>
<tr><td><code>zoom</code>, <code>pitch</code></td><td data-i18n="tty.row_zoom_meaning">Camera distance and elevation.</td><td>1, 0.08</td></tr>
</tbody>
</table>
<pre class="block"><code># your own avatar, wider, held still
curl 'three.ws/tty/<avatar-id>?w=110&spin=0'
# a single frame in plain ASCII, for a README or a commit hook
curl 'three.ws/tty?frames=1&color=mono&w=60'</code></pre>
<p class="note" data-i18n-html="tty.note">
A browser asking for this URL is redirected here instead, because a browser would
show the escape codes as literal garbage. Pass
<code style="color:var(--tty-accent)">?raw=1</code> to see the bytes anyway.
</p>
</section>
<section>
<h2 data-i18n="tty.how_h">How it works</h2>
<div class="grid">
<div class="card">
<h3 data-i18n="tty.card1_title">Half blocks, not ASCII art</h3>
<p data-i18n-html="tty.card1_desc">Each cell is a <code>▀</code> with its own foreground and background colour, so one character carries two pixels. That doubles vertical resolution and makes pixels square, which is why a sphere comes out round.</p>
</div>
<div class="card">
<h3 data-i18n="tty.card2_title">Real skinning</h3>
<p data-i18n="tty.card2_desc">Joint matrices are evaluated per frame and blended per vertex, so a rigged avatar actually moves its limbs. It is not a spinning static mesh.</p>
</div>
<div class="card">
<h3 data-i18n="tty.card3_title">Framing that holds still</h3>
<p data-i18n="tty.card3_desc">The camera radius is fixed from the widest frame of the clip and the centre tracks the pose, so a walk cycle with root motion neither breathes nor walks out of shot.</p>
</div>
<div class="card">
<h3 data-i18n="tty.card4_title">Silhouette-first shading</h3>
<p data-i18n="tty.card4_desc">A key light, a fill, and a rim term. At this resolution the outline carries the shape, so faces turning away are lifted rather than crushed to black.</p>
</div>
</div>
</section>
<footer>
<a href="/docs/tty" data-i18n="tty.foot_docs">Docs</a>
<a href="/gallery" data-i18n="tty.foot_avatars">Avatars</a>
<a href="/create" data-i18n="tty.foot_create">Create an agent</a>
<a href="https://github.com/nirholas/three.ws/tree/main/packages/tty-3d" data-i18n="tty.foot_source">Source</a>
</footer>
</main>
<script type="module" src="/src/tty-page.js"></script>
<script type="module" src="/i18n.js"></script>
</body>
</html>