Clawd Computer: web-based homebase computer (ttyd + nginx + toolbelt)

Dockerfile

@@ -0,0 +1,47 @@
+# Clawd Computer — a real web-based computer for the Clawd agents
+FROM debian:bookworm-slim
+
+ENV DEBIAN_FRONTEND=noninteractive \
+    HOME=/home/user \
+    PATH=/home/user/.local/bin:/usr/local/bin:$PATH \
+    PYTHONUNBUFFERED=1
+
+# Core userland + tools the agents reach for
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        ca-certificates curl wget git jq ripgrep nano vim less \
+        build-essential python3 python3-pip python3-venv \
+        nginx supervisor ttyd locales tini \
+    && sed -i 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen && locale-gen \
+    && rm -rf /var/lib/apt/lists/*
+
+ENV LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8
+
+# Node.js 20 (NodeSource)
+RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
+    && apt-get install -y --no-install-recommends nodejs \
+    && rm -rf /var/lib/apt/lists/*
+
+# Hugging Face CLI
+RUN pip3 install --no-cache-dir --break-system-packages huggingface_hub
+
+# Non-root user (HF Spaces run as uid 1000)
+RUN useradd -m -u 1000 user || true
+
+# nginx must be writable/runnable by uid 1000
+RUN mkdir -p /var/lib/nginx /var/log/nginx /run \
+    && chown -R user:user /var/lib/nginx /var/log/nginx /run /etc/nginx
+
+COPY --chown=user:user nginx.conf /etc/nginx/nginx.conf
+COPY --chown=user:user supervisord.conf /etc/supervisor/conf.d/supervisord.conf
+COPY --chown=user:user web/ /home/user/web/
+COPY --chown=user:user welcome.sh /home/user/welcome.sh
+
+RUN chmod +x /home/user/welcome.sh
+
+USER user
+WORKDIR /home/user/app
+
+EXPOSE 7860
+
+ENTRYPOINT ["/usr/bin/tini", "--"]
+CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"]

README.md

@@ -1,10 +1,47 @@
 ---
 title: Clawd Computer
-emoji: ⚡
+emoji: 🐾
 colorFrom: purple
-colorTo: purple
+colorTo: indigo
 sdk: docker
-pinned: false
+app_port: 7860
+pinned: true
+license: mit
+short_description: Web-based computer + live terminal for Clawd agents
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🐾 Clawd Computer
+
+A **real, browser-accessible computer** for the [Clawd](https://huggingface.co/solanaclawd) agents — the homebase on Hugging Face.
+
+It is a Docker Space that boots a full Debian userland with a live web terminal (`ttyd`) and a landing console served by `nginx`. Pre-loaded with the tools the agents reach for: Python, Node.js, git, the Hugging Face `hf` CLI, ripgrep, jq, and more.
+
+## What's inside
+
+| Layer | Tool |
+|-------|------|
+| Web terminal | [`ttyd`](https://github.com/tsl0922/ttyd) → bash |
+| Reverse proxy | `nginx` (serves landing + websocket-proxies the terminal) |
+| Process manager | `supervisord` |
+| Runtime | Python 3, Node.js 20, git, curl, jq, ripgrep, `hf` CLI |
+
+## Layout
+
+- `/` — the homebase landing console
+- `/terminal/` — the live interactive terminal
+
+## Run it locally
+
+```bash
+docker build -t clawd-computer .
+docker run -p 7860:7860 clawd-computer
+# open http://localhost:7860
+```
+
+## Secrets
+
+Set `HF_TOKEN` (and any other keys) in the Space **Settings → Secrets**. They are injected as environment variables at runtime and are available inside the terminal.
+
+---
+
+Part of the **Clawd** homebase on Hugging Face. 🐾

nginx.conf

@@ -0,0 +1,41 @@
+worker_processes 1;
+error_log /var/log/nginx/error.log warn;
+pid /run/nginx.pid;
+
+events { worker_connections 1024; }
+
+http {
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+    access_log    /var/log/nginx/access.log;
+    sendfile      on;
+
+    map $http_upgrade $connection_upgrade {
+        default upgrade;
+        ''      close;
+    }
+
+    server {
+        listen 7860;
+        server_name _;
+
+        root /home/user/web;
+        index index.html;
+
+        # Homebase landing
+        location / {
+            try_files $uri $uri/ =404;
+        }
+
+        # Live web terminal (ttyd on 7681)
+        location /terminal/ {
+            proxy_pass http://127.0.0.1:7681/;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection $connection_upgrade;
+            proxy_set_header Host $host;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_read_timeout 86400;
+        }
+    }
+}

supervisord.conf

@@ -0,0 +1,17 @@
+[supervisord]
+nodaemon=true
+user=user
+logfile=/var/log/nginx/supervisord.log
+pidfile=/run/supervisord.pid
+
+[program:ttyd]
+command=ttyd -p 7681 -i 127.0.0.1 -W -t fontSize=15 -t 'theme={"background":"#11071f"}' bash -lc "cd /home/user/app && /home/user/welcome.sh && exec bash"
+autorestart=true
+stdout_logfile=/var/log/nginx/ttyd.log
+stderr_logfile=/var/log/nginx/ttyd.err.log
+
+[program:nginx]
+command=nginx -g "daemon off;"
+autorestart=true
+stdout_logfile=/var/log/nginx/nginx.out.log
+stderr_logfile=/var/log/nginx/nginx.err.log

web/index.html

@@ -0,0 +1,136 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>Clawd Computer 🐾</title>
+<style>
+  :root {
+    --bg: #0a0612;
+    --panel: #150a26;
+    --panel-2: #1d0f33;
+    --accent: #a779ff;
+    --accent-2: #6c4bd6;
+    --text: #ece6ff;
+    --muted: #9a8cc0;
+    --border: #2a1a47;
+  }
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    font-family: ui-monospace, "SF Mono", "JetBrains Mono", Menlo, monospace;
+    background: radial-gradient(1200px 600px at 70% -10%, #2a1252 0%, var(--bg) 60%);
+    color: var(--text);
+    min-height: 100vh;
+    display: flex;
+    flex-direction: column;
+  }
+  header {
+    padding: 22px 28px;
+    display: flex;
+    align-items: center;
+    gap: 14px;
+    border-bottom: 1px solid var(--border);
+    background: rgba(21,10,38,0.6);
+    backdrop-filter: blur(8px);
+  }
+  header .logo { font-size: 30px; }
+  header h1 { font-size: 18px; letter-spacing: 0.5px; }
+  header h1 span { color: var(--accent); }
+  header .spacer { flex: 1; }
+  header a.badge {
+    color: var(--muted); text-decoration: none; font-size: 13px;
+    border: 1px solid var(--border); padding: 6px 12px; border-radius: 8px;
+    transition: 0.2s;
+  }
+  header a.badge:hover { color: var(--text); border-color: var(--accent); }
+  main {
+    flex: 1;
+    display: grid;
+    grid-template-columns: 300px 1fr;
+    gap: 18px;
+    padding: 18px 22px 22px;
+  }
+  @media (max-width: 820px) { main { grid-template-columns: 1fr; } }
+  .sidebar { display: flex; flex-direction: column; gap: 14px; }
+  .card {
+    background: linear-gradient(160deg, var(--panel) 0%, var(--panel-2) 100%);
+    border: 1px solid var(--border);
+    border-radius: 14px;
+    padding: 16px 18px;
+  }
+  .card h2 { font-size: 12px; text-transform: uppercase; letter-spacing: 1px; color: var(--muted); margin-bottom: 10px; }
+  .card p { font-size: 13px; color: var(--text); line-height: 1.6; }
+  .pill { display:inline-block; font-size:11px; color:var(--accent); background:rgba(167,121,255,0.12);
+          border:1px solid var(--accent-2); padding:3px 9px; border-radius:20px; margin:3px 4px 0 0; }
+  .terminal-wrap {
+    border: 1px solid var(--border);
+    border-radius: 14px;
+    overflow: hidden;
+    background: #11071f;
+    display: flex;
+    flex-direction: column;
+    min-height: 520px;
+  }
+  .term-bar {
+    display: flex; align-items: center; gap: 8px;
+    padding: 10px 14px; background: #1a0d30; border-bottom: 1px solid var(--border);
+  }
+  .term-bar .dot { width: 11px; height: 11px; border-radius: 50%; }
+  .d1 { background:#ff5f56; } .d2 { background:#ffbd2e; } .d3 { background:#27c93f; }
+  .term-bar .title { margin-left: 8px; font-size: 12px; color: var(--muted); }
+  iframe { border: 0; width: 100%; flex: 1; min-height: 480px; background:#11071f; }
+  footer { padding: 14px 28px; border-top: 1px solid var(--border); color: var(--muted); font-size: 12px; text-align:center; }
+  footer a { color: var(--accent); text-decoration: none; }
+</style>
+</head>
+<body>
+  <header>
+    <span class="logo">🐾</span>
+    <h1>Clawd <span>Computer</span></h1>
+    <div class="spacer"></div>
+    <a class="badge" href="https://huggingface.co/solanaclawd" target="_blank">solanaclawd org ↗</a>
+    <a class="badge" href="/terminal/" target="_blank">open terminal ↗</a>
+  </header>
+
+  <main>
+    <div class="sidebar">
+      <div class="card">
+        <h2>Homebase</h2>
+        <p>A real, browser-accessible computer for the Clawd agents — running on Hugging Face Spaces.</p>
+      </div>
+      <div class="card">
+        <h2>Toolbelt</h2>
+        <div>
+          <span class="pill">python3</span><span class="pill">node 20</span>
+          <span class="pill">git</span><span class="pill">hf cli</span>
+          <span class="pill">jq</span><span class="pill">ripgrep</span>
+          <span class="pill">bash</span><span class="pill">curl</span>
+        </div>
+      </div>
+      <div class="card">
+        <h2>Quick start</h2>
+        <p>In the terminal →<br>
+        <code>hf auth whoami</code><br>
+        <code>hf models ls --author solanaclawd</code><br>
+        <code>python3 --version</code></p>
+      </div>
+      <div class="card">
+        <h2>Secrets</h2>
+        <p>Set <code>HF_TOKEN</code> in <em>Settings → Secrets</em>. It's injected as an env var in the terminal.</p>
+      </div>
+    </div>
+
+    <div class="terminal-wrap">
+      <div class="term-bar">
+        <span class="dot d1"></span><span class="dot d2"></span><span class="dot d3"></span>
+        <span class="title">clawd@homebase: ~/app</span>
+      </div>
+      <iframe src="/terminal/" title="Clawd Computer terminal"></iframe>
+    </div>
+  </main>
+
+  <footer>
+    🐾 Clawd Computer · part of the <a href="https://huggingface.co/solanaclawd">Clawd</a> homebase on Hugging Face
+  </footer>
+</body>
+</html>

welcome.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+cat <<'BANNER'
+   ____ _                  _    ____                            _
+  / ___| | __ ___      ____| |  / ___|___  _ __ ___  _ __  _   _| |_ ___ _ __
+ | |   | |/ _` \ \ /\ / / _` | | |   / _ \| '_ ` _ \| '_ \| | | | __/ _ \ '__|
+ | |___| | (_| |\ V  V / (_| | | |__| (_) | | | | | | |_) | |_| | ||  __/ |
+  \____|_|\__,_| \_/\_/ \__,_|  \____\___/|_| |_| |_| .__/ \__,_|\__\___|_|
+                                                    |_|
+BANNER
+echo ""
+echo "  🐾 Welcome to the Clawd Computer — homebase on Hugging Face"
+echo "  ----------------------------------------------------------"
+echo "  Pre-installed: python3 · node $(node -v 2>/dev/null) · git · hf · jq · rg"
+echo "  HF CLI:        run 'hf auth whoami' (set HF_TOKEN in Space secrets)"
+echo "  Org:           https://huggingface.co/solanaclawd"
+echo ""