ThinkerWave showcase

.gitattributes

@@ -33,3 +33,6 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+assets/app-live-run.png filter=lfs diff=lfs merge=lfs -text
+assets/app-plan.png filter=lfs diff=lfs merge=lfs -text
+assets/demo.gif filter=lfs diff=lfs merge=lfs -text

README.md

@@ -1,10 +1,17 @@
 ---
-title: Thinkerwave
-emoji: 😻
-colorFrom: pink
-colorTo: purple
+title: ThinkerWave
+emoji: 🧭
+colorFrom: gray
+colorTo: indigo
 sdk: static
-pinned: false
+app_file: index.html
+pinned: true
+license: apache-2.0
+short_description: Research agent that labels each claim verified/assumed/guess
+tags:
+  - agents
+  - research
+  - mcp
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+ThinkerWave — an autonomous research agent for hard, open-ended questions. Try it free at https://thinkerwave.ai · SDK, CLI and MCP server: https://github.com/thinkerwave-ai/thinkerwave

index.html

@@ -1,19 +1,66 @@
 <!doctype html>
-<html>
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width" />
-		<title>My static Space</title>
-		<link rel="stylesheet" href="style.css" />
-	</head>
-	<body>
-		<div class="card">
-			<h1>Welcome to your static Space!</h1>
-			<p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
-			<p>
-				Also don't forget to check the
-				<a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
-			</p>
-		</div>
-	</body>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>ThinkerWave</title>
+<style>
+  :root { --bg:#f6f6f8; --card:#fff; --line:#dedee6; --text:#1a1a2e; --dim:#4a4a68; --muted:#85859e; --btn:#1a1a2e; --btnfg:#fff; }
+  @media (prefers-color-scheme: dark) { :root { --bg:#121219; --card:#1a1a24; --line:#2c2c3a; --text:#ececf2; --dim:#b4b4c6; --muted:#7c7c92; --btn:#ececf2; --btnfg:#121219; } }
+  body { margin:0; background:var(--bg); color:var(--text); font:17px/1.6 -apple-system, "Segoe UI", system-ui, sans-serif; }
+  .wrap { max-width: 920px; margin: 0 auto; padding: 48px 20px 72px; }
+  h1 { font: 650 44px/1.1 Georgia, "Times New Roman", serif; margin: 0 0 14px; }
+  .lead { font-size: 21px; color: var(--dim); max-width: 60ch; margin: 0 0 26px; }
+  .cta { display:flex; flex-wrap:wrap; gap:12px; margin-bottom: 36px; }
+  .btn { display:inline-block; padding: 12px 22px; border-radius: 10px; text-decoration:none; font-weight:600; }
+  .primary { background: var(--btn); color: var(--btnfg); }
+  .ghost { border:1px solid var(--line); color: var(--text); }
+  img { max-width:100%; border-radius: 12px; border:1px solid var(--line); display:block; }
+  h2 { font: 650 26px/1.2 Georgia, serif; margin: 52px 0 12px; }
+  .grid { display:grid; grid-template-columns: 1fr 1fr; gap: 20px; }
+  @media (max-width: 720px) { .grid { grid-template-columns: 1fr; } h1 { font-size: 34px; } }
+  .cap { color: var(--muted); font-size: 15px; margin: 8px 0 0; }
+  ol { padding-left: 22px; margin: 0; } ol li { margin-bottom: 8px; }
+  pre { background: var(--card); border:1px solid var(--line); border-radius: 10px; padding: 14px 16px; overflow-x:auto; font: 14px/1.5 ui-monospace, Menlo, monospace; }
+  .labels b { font-weight: 650; }
+  footer { margin-top: 56px; color: var(--muted); font-size: 14px; }
+  a { color: inherit; }
+</style>
+</head>
+<body>
+<div class="wrap">
+  <h1>ThinkerWave</h1>
+  <p class="lead">An autonomous research agent for hard, open-ended questions. It works the problem round after round, runs its own analysis code, checks its own work, and labels every claim in the answer <b>verified</b>, <b>assumption</b> or <b>guess</b>.</p>
+  <div class="cta">
+    <a class="btn primary" href="https://thinkerwave.ai" target="_blank" rel="noopener">Try it free at thinkerwave.ai</a>
+    <a class="btn ghost" href="https://github.com/thinkerwave-ai/thinkerwave" target="_blank" rel="noopener">GitHub: SDK, CLI, MCP server</a>
+  </div>
+
+  <img src="assets/demo.gif" alt="A real two-round ThinkerWave run in the terminal, ending with an answer whose claims are labelled verified, assumption or guess">
+  <p class="cap">A real run from the command line: the rounds as they happen, then the answer with its evidence labels.</p>
+
+  <h2>How it works</h2>
+  <ol>
+    <li><b>Describe a hard problem.</b> Paste your numbers and files; they're kept exactly as you give them.</li>
+    <li><b>Approve the plan.</b> See what it will aim for. Nothing runs until you press Launch.</li>
+    <li><b>It works on its own.</b> It tries, checks and improves, round after round, and keeps the best answer.</li>
+  </ol>
+
+  <h2>In the app</h2>
+  <div class="grid">
+    <div><img src="assets/app-plan.png" alt="The plan ThinkerWave proposes before a run, with the user's numbers listed as fixed inputs"><p class="cap">You approve the plan. Your numbers stay fixed.</p></div>
+    <div><img src="assets/app-live-run.png" alt="A live run: the engine view and the current answer"><p class="cap">Then it works on its own, round after round.</p></div>
+  </div>
+
+  <h2>From your code or your coding assistant</h2>
+<pre>pip install thinkerwave
+tw run "Should we raise prices 15%, 8%, or hold?" --given "1,200 customers" --watch
+
+# Claude Code or Cursor (MCP)
+claude mcp add thinkerwave --env THINKERWAVE_API_KEY=tw_live_… -- uvx thinkerwave-mcp</pre>
+  <p>Get an API key at thinkerwave.ai → Settings → API keys. Free runs are included with every account.</p>
+
+  <footer>Thinkerwave AITech Private Limited · <a href="https://thinkerwave.ai">thinkerwave.ai</a> · Apache-2.0 SDK on <a href="https://github.com/thinkerwave-ai/thinkerwave">GitHub</a> and <a href="https://pypi.org/project/thinkerwave/">PyPI</a></footer>
+</div>
+</body>
 </html>