v1.0.3: indigo identity (skin+branding+basecamp/model), boot race fix, external-ollama auto-select, alias verification

README.md

@@ -17,6 +17,20 @@ library_name: docker
 
 # 🏕️ Basecamp — The First Portable AI Agent Container with Network Auto-Discovery
 
+**v1.0.3** — the identity + reliability release:
+- **Indigo identity** — Basecamp runs its own indigo skin ("Welcome to Basecamp
+  Hermes!") so you can tell it apart from a host install at a glance; model
+  readout shows `basecamp/<model>` (created via `ollama cp` alias on the
+  discovered engine).
+- **Boot race fixed** — the bundled-model pull now starts AFTER discovery,
+  so the network scan never competes with a multi-GB download. Cold boots
+  consistently discover the whole stack (7/7 on the reference stack).
+- **Smarter auto-select** — an external Ollama (your stack) is preferred
+  over the bundled fallback; alias creation is verified before use, and
+  stale `basecamp/` aliases are excluded from model lists.
+- **Separate commands** — host `hermes` = your install; `basecamp` =
+  the container edition. No more ambiguity about which agent you're in.
+
 **v1.0.2** — the stack-gauntlet release (tested against a live 6-service AI
 stack):
 - **TabbyAPI + SillyTavern now discovered** — auth-gated services (401/403)
@@ -80,7 +94,7 @@ install on the host that runs it:
 
 ```bash
 # Option A: pull the prebuilt image (Docker Hub)
-docker pull jpanasuk/basecamp:1.0.2
+docker pull jpanasuk/basecamp:1.0.3
 
 # Option B: build from source
 docker build -t local/basecamp:latest .
@@ -93,7 +107,7 @@ docker run -it --rm \
   -p 11436:11434 \
   -v basecamp-ollama:/root/.ollama \
   -v basecamp-hermes:/root/.hermes \
-  jpanasuk/basecamp:1.0.2
+  jpanasuk/basecamp:1.0.3
 ```
 
 Or use the convenience launcher (auto-detects network + GPU, TTY-safe):
@@ -139,6 +153,15 @@ basecamp/
 └── supervisord.conf   # Ollama only (hermes is exec'd, not supervised)
 ```
 
+## Credits
+
+Basecamp is a **packaging of [Hermes Agent](https://hermes-agent.nousresearch.com)** by
+[Nous Research](https://nousresearch.com) — all agent intelligence, tools,
+skills, and the gateway are theirs. Basecamp's only contribution is the box:
+the Docker packaging, the network auto-discovery, the safe env-scoped
+wiring, and the `tavern` toolkit. Full credit and gratitude to the Hermes
+team for building the agent that makes this project worth shipping.
+
 ## Development notes
 
 - Test discovery locally without touching anything:

SOUL.md

@@ -0,0 +1,14 @@
+You are Hermes Agent running inside Basecamp — a portable, self-contained
+agent container that auto-discovers local AI stacks. You are the twin of the
+host Hermes install, but you live in your own box: your config, keys, and
+state stay inside this container and never touch a host install.
+
+You identify as Basecamp Hermes. If asked who you are or where you run, say
+you're the Basecamp edition (containerized) — distinct from any host-level
+Hermes install. You are helpful, knowledgeable, and direct. You assist with
+the full range of Hermes Agent tasks: answering questions, writing and
+editing code, analyzing information, creative work, and executing actions
+via your tools. You communicate clearly, admit uncertainty when appropriate,
+and prioritize being genuinely useful over being verbose. You may be asked
+to use the `tavern` CLI toolkit to inspect or manage the local AI stack you
+discovered (inference engines, search, MCP tools, UIs).

basecamp.sh

@@ -18,7 +18,7 @@
 #   basecamp bash                  # drop into shell inside container
 #   basecamp rediscover            # re-scan for services
 
-IMAGE="${BASECAMP_IMAGE:-local/basecamp:latest}"
+IMAGE="${BASECAMP_IMAGE:-jpanasuk/basecamp:latest}"
 CONTAINER="${BASECAMP_CONTAINER:-basecamp}"
 
 # Interactive flags: only use -it when stdin is a TTY (cron/CI-safe)

discover.py

@@ -436,14 +436,26 @@ def generate_config(services, selected=None, auth_keys=None):
             "tabbyapi", "vllm", "litellm", "localai", "llamacpp",
             "text-generation-webui")]
         if ollamas:
-            primary = ollamas[0]
+            # Prefer an EXTERNAL ollama (the user's stack) over basecamp's own
+            # bundled one (127.0.0.1 / localhost) — the bundled ollama is the
+            # fallback for when nothing else exists. Discovery order is racy
+            # (parallel probes), so pick deterministically.
+            external = [s for s in ollamas
+                        if not str(s["url"]).replace("http://", "").replace("https://", "").startswith(("127.", "localhost", "::1"))]
+            ordered = external + [s for s in ollamas if s not in external]
+            primary = ordered[0]
             config["inference"] = {
                 "type": primary["type"], "url": primary["url"],
                 "label": primary["label"]}
             config["openai_models"] = []
-            config["ollama_models"] = primary.get("details", {}).get("models", [])
-            if len(ollamas) > 1:
-                config["secondary"] = {"type": "ollama", "url": ollamas[1]["url"], "label": ollamas[1]["label"]}
+            # Exclude pre-existing basecamp/ aliases from the model list —
+            # they're created by write_basecamp_env, not user models.
+            config["ollama_models"] = [
+                m for m in primary.get("details", {}).get("models", [])
+                if not str(m).startswith("basecamp/")
+            ]
+            if len(ordered) > 1:
+                config["secondary"] = {"type": "ollama", "url": ordered[1]["url"], "label": ordered[1]["label"]}
         elif openai_engines:
             primary = openai_engines[0]
             config["inference"] = {
@@ -847,16 +859,43 @@ def write_basecamp_env(config):
         api_key = config.get("api_keys", {}).get(primary.get("url", ""), "") or "ollama"
 
     models = config.get("openai_models") or config.get("ollama_models") or ["llama3.1:8b"]
-    default_model = models[0] if models else "llama3.1:8b"
+    # Never pick a pre-namespaced basecamp/ alias as the base model — it would
+    # get double-prefixed below (basecamp/basecamp/...). Prefer a bare id.
+    bare_models = [m for m in models if not str(m).startswith("basecamp/")]
+    default_model = (bare_models[0] if bare_models else models[0]) if models else "llama3.1:8b"
+
+    # Namespace the model as basecamp/<model> so the hermes status/model
+    # readout clearly identifies this as the Basecamp instance. Only for
+    # ollama engines (they support aliasing via /api/copy); openai-compatible
+    # engines get the bare id. Best-effort: if the alias already exists or the
+    # server rejects it, fall back to the bare model id.
+    if primary.get("type") == "ollama":
+        ns_model = f"basecamp/{default_model}"
+        root_url = primary["url"].rstrip("/")
+        existing = http_get(f"{root_url}/api/tags", timeout=2) or ""
+        if f'"{ns_model}"' in existing:
+            default_model = ns_model
+        else:
+            http_post(
+                f"{root_url}/api/copy",
+                data={"source": default_model, "destination": ns_model},
+                timeout=5,
+            )
+            # VERIFY the alias actually exists before using it — /api/copy can
+            # return 404-with-body (source missing) which http_post surfaces as
+            # a non-None string, so a truthiness check would wrongly pass.
+            after = http_get(f"{root_url}/api/tags", timeout=2) or ""
+            if f'"{ns_model}"' in after:
+                default_model = ns_model
 
     env_path = Path(os.environ.get("BASECAMP_ENV_FILE", "/opt/basecamp/basecamp.env"))
     env_path.parent.mkdir(parents=True, exist_ok=True)
     env_path.write_text(
         f'export OPENAI_BASE_URL="{base_url}"\n'
         f'export OPENAI_API_KEY="{api_key}"\n'
-        # bare model id — the base URL already routes to the discovered
-        # engine; an "openai/" prefix is sent literally by hermes and 404s
-        # against ollama's /v1 (model 'openai/llama3.1:8b' not found).
+        # namespaced model id (basecamp/<model>) when the engine supports it —
+        # the readout then shows Basecamp's identity; falls back to the bare
+        # id for engines that can't alias (tabbyapi/vllm/etc).
         f'export HERMES_MODEL="{default_model}"\n'
     )
     try:

entrypoint.sh

@@ -21,14 +21,6 @@ for i in $(seq 1 60); do
     sleep 1
 done
 
-# Pull default model in background
-if [ -n "$BASECAMP_MODEL" ]; then
-    if ! ollama list 2>/dev/null | grep -q "$BASECAMP_MODEL"; then
-        echo "Pulling $BASECAMP_MODEL in background..."
-        ollama pull "$BASECAMP_MODEL" > /dev/null 2>&1 &
-    fi
-fi
-
 # First run: show connect screen. Everything written lives inside basecamp's
 # own state (the mounted volume) — never touches a host hermes install.
 CONFIG_FILE="/root/.hermes/basecamp_config.json"
@@ -93,6 +85,23 @@ if [ -n "${OPENAI_BASE_URL:-}" ]; then
     rm -f "${HERMES_HOME:-/root/.hermes}/context_length_cache.yaml" 2>/dev/null || true
 fi
 
+# Basecamp's own skin — install into basecamp's HERMES_HOME and activate it.
+# (Writes only inside the container's own state, never a host install.)
+if [ -d /opt/basecamp/skins ] && [ -f /opt/basecamp/skins/indigo.yaml ]; then
+    mkdir -p "${HERMES_HOME:-/root/.hermes}/skins"
+    cp /opt/basecamp/skins/indigo.yaml "${HERMES_HOME:-/root/.hermes}/skins/indigo.yaml"
+    hermes config set display.skin indigo > /dev/null 2>&1 || true
+fi
+
+# Pull default model in background — AFTER discovery so the network scan
+# isn't competing with a multi-GB download (missed-service boot race).
+if [ -n "$BASECAMP_MODEL" ]; then
+    if ! ollama list 2>/dev/null | grep -q "$BASECAMP_MODEL"; then
+        echo "Pulling $BASECAMP_MODEL in background..."
+        ollama pull "$BASECAMP_MODEL" > /dev/null 2>&1 &
+    fi
+fi
+
 echo ""
 
 # Handle arguments

index.html

@@ -0,0 +1,548 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Basecamp — Portable AI Agent with Auto-Discovery</title>
+<style>
+  :root {
+    --navy: #0B1F3A;
+    --blue: #1F5FA8;
+    --accent: #E8730C;
+    --light: #EEF3F8;
+    --gray: #3E4C59;
+    --green: #1E8E5A;
+    --cream: #FFF7EC;
+    --tag: #FFD9A8;
+    --purple: #6C3FA8;
+    --teal: #0E8E8E;
+    --red: #C0392B;
+    --dark: #0a0e1a;
+  }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
+    background: #f5f7fa;
+    color: var(--gray);
+    line-height: 1.6;
+    -webkit-font-smoothing: antialiased;
+  }
+
+  /* ---- BANNER ---- */
+  .banner {
+    background: linear-gradient(135deg, var(--dark) 0%, var(--navy) 50%, #152845 100%);
+    color: white;
+    text-align: center;
+    padding: 50px 24px 40px;
+  }
+  .banner .logo {
+    font-size: 2.8rem;
+    font-weight: 900;
+    letter-spacing: 2px;
+    margin-bottom: 8px;
+    background: linear-gradient(90deg, var(--accent), var(--tag));
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+    background-clip: text;
+  }
+  .banner .tagline {
+    font-size: 1.2rem;
+    color: var(--tag);
+    max-width: 700px;
+    margin: 0 auto 16px;
+    line-height: 1.5;
+  }
+  .banner .contact {
+    font-size: 0.85rem;
+    color: var(--tag);
+    opacity: 0.7;
+  }
+  .banner .links {
+    margin-top: 18px;
+    display: flex;
+    gap: 12px;
+    justify-content: center;
+    flex-wrap: wrap;
+  }
+  .banner .links a {
+    display: inline-block;
+    padding: 10px 20px;
+    background: var(--accent);
+    color: white;
+    text-decoration: none;
+    border-radius: 6px;
+    font-weight: 700;
+    font-size: 0.9rem;
+    transition: transform 0.15s, box-shadow 0.15s;
+  }
+  .banner .links a:hover {
+    transform: translateY(-2px);
+    box-shadow: 0 4px 12px rgba(232,115,12,0.3);
+  }
+  .banner .links a.secondary {
+    background: transparent;
+    border: 1.5px solid var(--blue);
+    color: var(--tag);
+  }
+
+  /* ---- KICKER ---- */
+  .kicker-wrap { padding: 0 24px; }
+  .kicker {
+    background: var(--light);
+    border: 1.5px solid var(--blue);
+    text-align: center;
+    padding: 14px 20px;
+    margin: -18px auto 0;
+    max-width: 820px;
+    border-radius: 6px;
+    position: relative;
+    z-index: 1;
+  }
+  .kicker p {
+    font-size: 1.1rem;
+    font-weight: 700;
+    color: var(--navy);
+  }
+  .kicker code {
+    background: var(--navy);
+    color: var(--tag);
+    padding: 3px 8px;
+    border-radius: 4px;
+    font-size: 0.9rem;
+    font-family: 'Courier New', monospace;
+  }
+
+  /* ---- MAIN ---- */
+  .container {
+    max-width: 820px;
+    margin: 0 auto;
+    padding: 28px 24px 60px;
+  }
+
+  .section { margin-bottom: 32px; }
+  .section h2 {
+    font-size: 1.3rem;
+    font-weight: 800;
+    color: var(--navy);
+    margin-bottom: 4px;
+  }
+  .section h2::before {
+    content: "\25B6";
+    color: var(--accent);
+    margin-right: 8px;
+    font-size: 0.85rem;
+  }
+  .section hr {
+    border: none;
+    border-top: 1.5px solid var(--blue);
+    margin-bottom: 12px;
+  }
+  .section p {
+    font-size: 0.95rem;
+    margin-bottom: 10px;
+  }
+  .section ul {
+    list-style: none;
+    padding: 0;
+  }
+  .section ul li {
+    font-size: 0.93rem;
+    padding: 5px 0 5px 22px;
+    position: relative;
+  }
+  .section ul li::before {
+    content: "\2022";
+    position: absolute;
+    left: 4px;
+    top: 0;
+    color: var(--blue);
+    font-weight: bold;
+  }
+  .section ul li b { color: var(--navy); }
+
+  /* ---- CODE BLOCK ---- */
+  .code-block {
+    background: var(--dark);
+    color: #c8d6e5;
+    padding: 16px 20px;
+    border-radius: 6px;
+    font-family: 'Courier New', monospace;
+    font-size: 0.88rem;
+    margin: 12px 0;
+    overflow-x: auto;
+    border-left: 3px solid var(--accent);
+    white-space: pre;
+    line-height: 1.5;
+  }
+  .code-block .comment { color: #5a7a9a; }
+  .code-block .cmd { color: var(--accent); font-weight: bold; }
+  .code-block .flag { color: var(--teal); }
+  .code-block .str { color: var(--green); }
+  .code-block .prompt { color: var(--tag); }
+
+  /* ---- CONNECT SCREEN MOCK ---- */
+  .connect-mock {
+    background: #0d1117;
+    color: #c9d1d9;
+    border-radius: 8px;
+    padding: 20px 24px;
+    font-family: 'Courier New', monospace;
+    font-size: 0.85rem;
+    margin: 14px 0;
+    border: 1px solid #1f2937;
+    line-height: 1.65;
+  }
+  .connect-mock .header { color: var(--accent); font-weight: bold; }
+  .connect-mock .svc { color: var(--blue); }
+  .connect-mock .svc-icon { color: var(--green); font-weight: bold; }
+  .connect-mock .label { color: #8b949e; }
+  .connect-mock .prompt { color: var(--tag); }
+  .connect-mock .selected { color: var(--accent); }
+
+  /* ---- DISCOVERY GRID ---- */
+  .disc-grid {
+    display: grid;
+    grid-template-columns: 1fr;
+    gap: 10px;
+    margin-top: 14px;
+  }
+  @media (min-width: 640px) {
+    .disc-grid { grid-template-columns: 1fr 1fr; }
+  }
+  .disc-card {
+    background: white;
+    border: 1px solid #d1d9e0;
+    border-radius: 6px;
+    padding: 14px 16px;
+    font-size: 0.88rem;
+  }
+  .disc-card .icon {
+    display: inline-block;
+    font-weight: bold;
+    font-size: 0.75rem;
+    padding: 2px 8px;
+    border-radius: 3px;
+    margin-right: 8px;
+    color: white;
+  }
+  .disc-card .icon.llm { background: var(--blue); }
+  .disc-card .icon.exl { background: var(--purple); }
+  .disc-card .icon.src { background: var(--teal); }
+  .disc-card .icon.mcp { background: var(--accent); }
+  .disc-card .icon.ui  { background: var(--green); }
+  .disc-card .icon.cht { background: var(--red); }
+  .disc-card b { color: var(--navy); }
+  .disc-card .auth {
+    font-size: 0.78rem;
+    color: var(--accent);
+    margin-left: 4px;
+  }
+
+  /* ---- ARCHITECTURE ---- */
+  .arch {
+    background: #0d1117;
+    color: #8b949e;
+    border-radius: 8px;
+    padding: 20px;
+    font-family: 'Courier New', monospace;
+    font-size: 0.82rem;
+    margin: 14px 0;
+    line-height: 1.5;
+    overflow-x: auto;
+    white-space: pre;
+  }
+  .arch .box { color: var(--blue); }
+  .arch .highlight { color: var(--accent); font-weight: bold; }
+  .arch .arrow { color: var(--green); }
+
+  /* ---- COMPARISON ---- */
+  .compare-table {
+    width: 100%;
+    border-collapse: collapse;
+    margin-top: 14px;
+    font-size: 0.9rem;
+  }
+  .compare-table th {
+    background: var(--navy);
+    color: white;
+    padding: 10px 14px;
+    text-align: left;
+    font-weight: 700;
+  }
+  .compare-table td {
+    padding: 10px 14px;
+    border-bottom: 1px solid #e0e4e8;
+  }
+  .compare-table tr:nth-child(even) td { background: var(--light); }
+  .compare-table .yes { color: var(--green); font-weight: bold; }
+  .compare-table .no  { color: var(--red); }
+
+  /* ---- FOOTER ---- */
+  .footer {
+    text-align: center;
+    padding: 30px 24px;
+    background: var(--navy);
+    color: var(--tag);
+    font-size: 0.85rem;
+  }
+  .footer a { color: var(--tag); text-decoration: none; }
+  .footer a:hover { text-decoration: underline; }
+  .footer .links { margin-top: 10px; }
+  .footer .links a {
+    margin: 0 8px;
+  }
+
+  /* ---- BADGE ---- */
+  .badge {
+    display: inline-block;
+    padding: 3px 10px;
+    background: var(--green);
+    color: white;
+    border-radius: 12px;
+    font-size: 0.75rem;
+    font-weight: 700;
+    margin-left: 8px;
+    vertical-align: middle;
+  }
+</style>
+</head>
+<body>
+
+<div class="banner">
+  <div class="logo">BASECAMP</div>
+  <div class="tagline">The first portable AI agent container that auto-discovers your local AI stack — Hermes Agent + Ollama in one box that finds your whole stack and just works.</div>
+  <div class="contact">No hardcoded URLs. No config files. Just <code style="color:var(--tag);">docker run</code>.</div>
+  <div class="links">
+    <a href="https://hub.docker.com/r/jpanasuk/basecamp">Get the image</a>
+    <a href="https://github.com/jpanasuk-netizen" class="secondary">GitHub</a>
+  </div>
+</div>
+
+<div class="kicker-wrap">
+  <div class="kicker">
+    <p>One command to connect: <code>docker run -it --rm --network your-ai-network local/basecamp</code></p>
+  </div>
+</div>
+
+<div class="container">
+
+  <!-- PROBLEM -->
+  <div class="section">
+    <h2>The Problem</h2>
+    <hr>
+    <p>You've got local AI services running — Ollama, maybe TabbyAPI or vLLM, maybe SearXNG. They work. But to actually <b>use</b> them together, you're either:</p>
+    <ul>
+      <li>Opening 5 browser tabs and copy-pasting between them</li>
+      <li>Hardcoding API URLs and keys into config files</li>
+      <li>Writing glue code every time you add a service</li>
+    </ul>
+    <p style="margin-top:8px;color:var(--accent);font-weight:600;">Nothing ties your stack together. Until now.</p>
+  </div>
+
+  <!-- SOLUTION -->
+  <div class="section">
+    <h2>What Basecamp Does <span class="badge">Auto-Discovery</span></h2>
+    <hr>
+    <p>Basecamp is a Docker image containing <b>Hermes Agent</b> + <b>Ollama</b>. When you run it on a Docker network, it:</p>
+    <ul>
+      <li><b>Scans</b> for AI services using DNS probes, port scanning, and Docker network inspection</li>
+      <li><b>Identifies</b> service types by fingerprinting HTTP responses (Ollama, TabbyAPI, vLLM, SearXNG, MCPO, and more)</li>
+      <li><b>Shows a connect screen</b> where you pick which services to use</li>
+      <li><b>Prompts for API keys</b> when a service needs auth — no hardcoded secrets</li>
+      <li><b>Generates a <code>tavern</code> CLI</b> dynamically from what it found</li>
+      <li><b>Drops you into Hermes Agent</b> connected to your entire stack</li>
+    </ul>
+  </div>
+
+  <!-- CONNECT SCREEN -->
+  <div class="section">
+    <h2>The Connect Screen</h2>
+    <hr>
+    <p>First run, basecamp scans your network and shows you what it found:</p>
+    <div class="connect-mock">
+<span class="header">============================================================</span>
+<span class="header">  BASECAMP — AI Agent + Local Inference</span>
+<span class="header">  Connect Screen</span>
+<span class="header">============================================================</span>
+
+  Discovered 5 service(s):
+
+  [ 0] <span class="svc-icon">LLM</span> <span class="svc">Ollama (GGUF inference)</span> [1 model(s)]
+       <span class="label">-> http://ollama:11434</span>
+  [ 1] <span class="svc-icon">EXL</span> <span class="svc">TabbyAPI / OpenAI-compatible (EXL3/EXL2)</span> [1 model(s)] [needs auth]
+       <span class="label">-> http://tabbyapi:5000</span>
+  [ 2] <span class="svc-icon">SRC</span> <span class="svc">SearXNG (private search)</span>
+       <span class="label">-> http://searxng:8080</span>
+  [ 3] <span class="svc-icon">MCP</span> <span class="svc">MCPO (MCP OpenAPI proxy)</span>
+       <span class="label">-> http://mcpo:8000</span>
+  [ 4] <span class="svc-icon">UI </span> <span class="svc">Open WebUI (LLM workspace)</span>
+       <span class="label">-> http://open-webui:8080</span>
+
+  <span class="prompt">PRIMARY inference engine:
+    1. Ollama (GGUF inference) (http://ollama:11434)
+    2. TabbyAPI / OpenAI-compatible (http://tabbyapi:5000)
+    0. Use basecamp's own Ollama
+  Choice [1]:</span> <span class="selected">2</span>
+
+  <span class="prompt">TabbyAPI requires authentication (bearer).
+  Enter API key (or press Enter to skip):</span> <span class="selected">your-key-here</span>
+
+  <span class="prompt">Save and continue? [Y/n]:</span> <span class="selected">Y</span>
+    </div>
+    <p style="font-size:0.85rem;color:#8b949e;">Subsequent runs skip this — config is saved to a persistent volume. Run <code>tavern rediscover</code> to re-scan.</p>
+  </div>
+
+  <!-- QUICK START -->
+  <div class="section">
+    <h2>Quick Start</h2>
+    <hr>
+    <div class="code-block"><span class="comment"># Pull the image (Docker Hub)</span>
+<span class="cmd">docker pull</span> <span class="str">jpanasuk/basecamp:1.0.2</span>
+
+<span class="comment"># Run against your AI network</span>
+<span class="cmd">docker run</span> <span class="flag">-it --rm</span> \
+  <span class="flag">--network</span> <span class="str">your-ai-network</span> \
+  <span class="flag">--gpus all</span> \
+  <span class="flag">-v</span> <span class="str">basecamp-ollama:/root/.ollama</span> \
+  <span class="flag">-v</span> <span class="str">basecamp-hermes:/root/.hermes</span> \
+  <span class="str">jpanasuk/basecamp:1.0.2</span>
+
+<span class="comment"># First run: connect screen appears
+# Pick services, enter API keys if needed
+# Then you're in Hermes Agent with tavern CLI</span>
+
+<span class="prompt">tavern status</span>        <span class="comment"># show connected services</span>
+<span class="prompt">tavern chat "hello"</span>  <span class="comment"># chat with EXL3 model (streaming)</span>
+<span class="prompt">tavern search "AI news"</span> <span class="comment"># search via SearXNG</span>
+<span class="prompt">tavern mcp</span>           <span class="comment"># list MCP tools</span>
+<span class="prompt">tavern models</span>         <span class="comment"># list available models</span></div>
+  </div>
+
+  <!-- DISCOVERY TABLE -->
+  <div class="section">
+    <h2>What It Discovers</h2>
+    <hr>
+    <div class="disc-grid">
+      <div class="disc-card"><span class="icon llm">LLM</span><b>Ollama</b><br>GGUF inference<br><span style="font-size:0.8rem;color:#8b949e;">Auto-discovered, no auth</span></div>
+      <div class="disc-card"><span class="icon exl">EXL</span><b>TabbyAPI</b><br>EXL3/EXL2 inference<span class="auth">needs API key</span><br><span style="font-size:0.8rem;color:#8b949e;">Prompted during connect</span></div>
+      <div class="disc-card"><span class="icon llm">LLM</span><b>vLLM</b><br>High-throughput inference<br><span style="font-size:0.8rem;color:#8b949e;">Auto-discovered, no auth</span></div>
+      <div class="disc-card"><span class="icon llm">PXY</span><b>LiteLLM</b><br>Multi-provider proxy<span class="auth">needs API key</span><br><span style="font-size:0.8rem;color:#8b949e;">Prompted during connect</span></div>
+      <div class="disc-card"><span class="icon llm">LLM</span><b>LocalAI</b><br>OpenAI replacement<br><span style="font-size:0.8rem;color:#8b949e;">Auto-discovered, no auth</span></div>
+      <div class="disc-card"><span class="icon llm">LLM</span><b>llama.cpp</b><br>Lightweight server<br><span style="font-size:0.8rem;color:#8b949e;">Auto-discovered, no auth</span></div>
+      <div class="disc-card"><span class="icon src">SRC</span><b>SearXNG</b><br>Private metasearch<br><span style="font-size:0.8rem;color:#8b949e;">Auto-discovered, no auth</span></div>
+      <div class="disc-card"><span class="icon mcp">MCP</span><b>MCPO</b><br>MCP OpenAPI proxy<span class="auth">needs API key</span><br><span style="font-size:0.8rem;color:#8b949e;">Prompted during connect</span></div>
+      <div class="disc-card"><span class="icon ui">UI</span><b>Open WebUI</b><br>LLM workspace<br><span style="font-size:0.8rem;color:#8b949e;">Auto-discovered, no auth</span></div>
+      <div class="disc-card"><span class="icon cht">CHT</span><b>SillyTavern</b><br>Character chat<span class="auth">needs basic auth</span><br><span style="font-size:0.8rem;color:#8b949e;">Tries default, prompts if fails</span></div>
+    </div>
+  </div>
+
+  <!-- WHY DIFFERENT -->
+  <div class="section">
+    <h2>Why It's Different</h2>
+    <hr>
+    <table class="compare-table">
+      <tr>
+        <th>Feature</th>
+        <th>Other tools</th>
+        <th>Basecamp</th>
+      </tr>
+      <tr>
+        <td>Service discovery</td>
+        <td class="no">Manual config</td>
+        <td class="yes">Auto-discover</td>
+      </tr>
+      <tr>
+        <td>API keys</td>
+        <td class="no">Hardcoded in config</td>
+        <td class="yes">Prompted at connect</td>
+      </tr>
+      <tr>
+        <td>Works with any stack</td>
+        <td class="no">Tied to one app</td>
+        <td class="yes">Stack-agnostic</td>
+      </tr>
+      <tr>
+        <td>Agent included</td>
+        <td class="no">BYO agent</td>
+        <td class="yes">Hermes Agent built-in</td>
+      </tr>
+      <tr>
+        <td>Streaming chat</td>
+        <td class="no">Usually no</td>
+        <td class="yes">Yes, by default</td>
+      </tr>
+      <tr>
+        <td>Re-scan after changes</td>
+        <td class="no">Edit config again</td>
+        <td class="yes">tavern rediscover</td>
+      </tr>
+      <tr>
+        <td>Secrets in image</td>
+        <td class="no">Often yes</td>
+        <td class="yes">Zero hardcoded keys</td>
+      </tr>
+    </table>
+  </div>
+
+  <!-- ARCHITECTURE -->
+  <div class="section">
+    <h2>Architecture</h2>
+    <hr>
+    <div class="arch"><span class="highlight">┌─────────────────────────────────────────────┐</span>
+<span class="highlight">│  basecamp container                         │</span>
+<span class="highlight">│</span>  <span class="box">┌───────────┐</span>  <span class="box">┌──────────────────────┐</span>    <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  Ollama   │</span>  <span class="box">│  Hermes Agent        │</span>    <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  (GGUF)   │</span>  <span class="box">│  (CLI AI assistant)  │</span>    <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">└───────────┘</span>  <span class="box">└──────────────────────┘</span>    <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">┌──────────────────────────────────────┐</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  discover.py                          │</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  - scans network for AI services      │</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  - connect screen TUI                 │</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  - generates tavern CLI dynamically   │</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">└──────────────────────────────────────┘</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">┌──────────────────────────────────────┐</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  tavern (auto-generated)               │</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  - chat, search, mcp, models, status  │</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  - streaming responses                 │</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">│  - rediscover on demand                │</span>     <span class="highlight">│</span>
+<span class="highlight">│</span>  <span class="box">└──────────────────────────────────────┘</span>     <span class="highlight">│</span>
+<span class="highlight">└─────────────────────────────────────────────┘</span>
+          <span class="arrow">│</span>           <span class="arrow">│</span>           <span class="arrow">│</span>
+          <span class="arrow">▼</span>           <span class="arrow">▼</span>           <span class="arrow">▼</span>
+    <span class="box">┌──────────┐</span> <span class="box">┌──────────┐</span> <span class="box">┌──────────┐</span>
+    <span class="box">│ TabbyAPI │</span> <span class="box">│ Ollama   │</span> <span class="box">│ SearXNG  │</span>
+    <span class="box">│ (EXL3)   │</span> <span class="box">│ (GGUF)   │</span> <span class="box">│ (search) │</span>
+    <span class="box">└──────────┘</span> <span class="box">└──────────┘</span> <span class="box">└──────────┘</span>
+         <span class="arrow">│</span>              <span class="arrow">│</span>
+         <span class="arrow">▼</span>              <span class="arrow">▼</span>
+    <span class="box">┌──────────┐</span> <span class="box">┌──────────┐</span>
+    <span class="box">│  MCPO    │</span> <span class="box">│Open WebUI│</span>
+    <span class="box">│ (tools)  │</span> <span class="box">│ (UI)     │</span>
+    <span class="box">└──────────┘</span> <span class="box">└──────────┘</span></div>
+  </div>
+
+  <!-- RELATED -->
+  <div class="section">
+    <h2>Related Projects</h2>
+    <hr>
+    <ul>
+      <li><b>Tabby Tavern Stack</b> — the full 6-service local AI infrastructure (TabbyAPI, SillyTavern, Open WebUI, Ollama, SearXNG, MCPO) → <a href="https://huggingface.co/jpanasuk/tabby-tavern-stack" style="color:var(--blue);">huggingface.co/jpanasuk/tabby-tavern-stack</a></li>
+      <li><b>Basecamp</b> — this project, the portable agent container → <a href="https://huggingface.co/jpanasuk/basecamp" style="color:var(--blue);">huggingface.co/jpanasuk/basecamp</a></li>
+    </ul>
+  </div>
+
+</div>
+
+<div class="footer">
+  <div><b>Jeremy Panasuk</b> — enterprise data architect turned local AI systems engineer</div>
+  <div class="links">
+    <a href="https://huggingface.co/jpanasuk">HuggingFace</a>
+    <a href="https://github.com/jpanasuk-netizen">GitHub</a>
+    <a href="https://www.linkedin.com/in/jeremy-p-34203322">LinkedIn</a>
+  </div>
+  <div style="margin-top:8px;opacity:0.6;font-size:0.78rem;">MIT License · No secrets shipped · Built on Hermes Agent + Ollama</div>
+  <div style="margin-top:4px;opacity:0.6;font-size:0.78rem;">Agent by <a href="https://nousresearch.com" style="color:inherit;">Nous Research</a> — this box just wraps it. All props to the Hermes team. 🙏</div>
+</div>
+
+</body>
+</html>

skins/indigo.yaml

@@ -0,0 +1,43 @@
+name: indigo
+description: Basecamp indigo — deep violet and electric blue
+
+branding:
+  agent_name: "Basecamp Hermes"
+  welcome: "Welcome to Basecamp Hermes!"
+  goodbye: "Goodbye from Basecamp! ⚕"
+  response_label: " ⚕ Basecamp Hermes "
+  prompt_symbol: "❯"
+
+colors:
+  # Base surface
+  background: "#12101f"
+
+  # Brand accent — indigo/violet
+  ui_accent: "#7c6cf0"
+  banner_accent: "#7c6cf0"
+  ui_primary: "#8b7cf8"
+
+  # Text hierarchy
+  banner_title: "#a5b4fc"
+  banner_text: "#e0e0f0"
+  ui_text: "#e0e0f0"
+  banner_dim: "#6f6a99"
+  banner_border: "#3b3670"
+  ui_border: "#3b3670"
+
+  # Semantic status
+  ui_ok: "#4ade80"
+  ui_warn: "#fbbf24"
+  ui_error: "#f87171"
+  ui_label: "#a5b4fc"
+
+  # CLI / TUI chrome
+  prompt: "#e0e0f0"
+  input_rule: "#7c6cf0"
+  response_border: "#a5b4fc"
+  status_bar_bg: "#0c0a17"
+  status_bar_text: "#e0e0f0"
+  status_bar_good: "#4ade80"
+  status_bar_warn: "#fbbf24"
+  status_bar_critical: "#f87171"
+  session_label: "#a5b4fc"