humanbottasks 0.1.0__tar.gz → 0.1.2__tar.gz

humanbottasks-0.1.2/Dockerfile

@@ -0,0 +1,9 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+COPY server.py store.py fulfill.py alarm.py pyproject.toml README.md LICENSE ./
+
+RUN pip install --no-cache-dir "mcp<2"
+
+CMD ["python", "server.py"]

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/FORUM_POSTS.md

@@ -1,69 +1,69 @@
-# Forum-/Community-Posts (fertig zum Copy-Paste)
-
-Englisch, weil die Zielgruppe (AI-Builder) englischsprachig ist.
-Posten braucht deine Accounts — die Texte sind einsatzbereit.
-
----
-
-## Reddit r/MCP
-
-**Title:** I built humanbottasks — delegate anything your agent can't do to a real human, over MCP
-
-**Body:**
-Two tools. That's the whole API:
-
-- `request_human_task(type, description, max_price)` — verification, physical_action, subjective_judgment, ground_truth_labeling, prove_human
-- `get_task_status(task_id)` — poll for the result
-
-Install: `uvx --from git+https://github.com/humanbottasks/humanbottasks humanbottasks`
-
-Works over stdio (Claude Desktop, Cursor, Windsurf) and streamable-http (remote agents).
-
-I built this because I kept hitting the same wall: agents confidently asserting things they couldn't verify, with no clean handoff for the parts only a human can do. The existing options either want me to wire up a marketplace account or bolt on a whole SDK — I wanted the thinnest possible thing that just works.
-
-It's an MVP (SQLite queue, no payments yet — I fulfill tasks manually right now). Honest question for this sub: which task type actually matters to you? Where do your agents actually get stuck?
-
-Repo: https://github.com/humanbottasks/humanbottasks
-
----
-
-## Reddit r/LocalLLaMA
-
-**Title:** Local agents can now call a human — humanbottasks (MCP, stdio, no cloud)
-
-**Body:**
-If you run local agents (Ollama/LM Studio + LangChain/CrewAI), here's a human-in-the-loop fallback that's just an MCP server on your own machine. No cloud account, no hosted service.
-
-- stdio (spawn it as a subprocess, same as any MCP server) + streamable-http for remote
-- Two tools: request_human_task / get_task_status
-- SQLite queue, you (or anyone) fulfill via a one-line CLI
-
-Install: `uvx --from git+https://github.com/humanbottasks/humanbottasks humanbottasks`
-
-Why this matters for local agents specifically: local models are even worse at verification and physical-world actions than frontier models, and they can't buy things or pick up a phone at all. A local agent that can delegate the "actually check this" part to a human is much more useful.
-
-Repo: https://github.com/humanbottasks/humanbottasks
-
----
-
-## X/Twitter (Thread, 3 Posts)
-
-**Post 1:**
-Your agent can't do everything. Now it can ask a human — over MCP, one line:
-`uvx --from git+https://github.com/humanbottasks/humanbottasks humanbottasks`
-
-**Post 2:**
-Two tools: `request_human_task` and `get_task_status`. That's it. Verification, physical actions, subjective judgment, ground-truth labeling — delegate it to a real person, poll for the result. stdio + streamable-http.
-
-**Post 3:**
-Built this after watching agents confidently assert things they couldn't verify, with no clean handoff for the human parts. Open source, MIT, works with Claude Desktop / Cursor / Windsurf / local agents.
-https://github.com/humanbottasks/humanbottasks
-
----
-
-## Discord (MCP / LangChain / n8n / Dify servers)
-
-**Kurzer Blurb:**
-> humanbottasks — human fallback for AI agents over MCP. Two tools (request_human_task / get_task_status), stdio + streamable-http, one-line install:
-> `uvx --from git+https://github.com/humanbottasks/humanbottasks humanbottasks`
-> MIT, works with Claude Desktop/Cursor/Windsurf and local agent frameworks.
+# Forum-/Community-Posts (fertig zum Copy-Paste)
+
+Englisch, weil die Zielgruppe (AI-Builder) englischsprachig ist.
+Posten braucht deine Accounts — die Texte sind einsatzbereit.
+
+---
+
+## Reddit r/MCP
+
+**Title:** I built humanbottasks — delegate anything your agent can't do to a real human, over MCP
+
+**Body:**
+Two tools. That's the whole API:
+
+- `request_human_task(type, description, max_price)` — verification, physical_action, subjective_judgment, ground_truth_labeling, prove_human
+- `get_task_status(task_id)` — poll for the result
+
+Install: `uvx humanbottasks`
+
+Works over stdio (Claude Desktop, Cursor, Windsurf) and streamable-http (remote agents).
+
+I built this because I kept hitting the same wall: agents confidently asserting things they couldn't verify, with no clean handoff for the parts only a human can do. The existing options either want me to wire up a marketplace account or bolt on a whole SDK — I wanted the thinnest possible thing that just works.
+
+It's an MVP (SQLite queue, no payments yet — I fulfill tasks manually right now). Honest question for this sub: which task type actually matters to you? Where do your agents actually get stuck?
+
+Repo: https://github.com/humanbottasks/humanbottasks
+
+---
+
+## Reddit r/LocalLLaMA
+
+**Title:** Local agents can now call a human — humanbottasks (MCP, stdio, no cloud)
+
+**Body:**
+If you run local agents (Ollama/LM Studio + LangChain/CrewAI), here's a human-in-the-loop fallback that's just an MCP server on your own machine. No cloud account, no hosted service.
+
+- stdio (spawn it as a subprocess, same as any MCP server) + streamable-http for remote
+- Two tools: request_human_task / get_task_status
+- SQLite queue, you (or anyone) fulfill via a one-line CLI
+
+Install: `uvx humanbottasks`
+
+Why this matters for local agents specifically: local models are even worse at verification and physical-world actions than frontier models, and they can't buy things or pick up a phone at all. A local agent that can delegate the "actually check this" part to a human is much more useful.
+
+Repo: https://github.com/humanbottasks/humanbottasks
+
+---
+
+## X/Twitter (Thread, 3 Posts)
+
+**Post 1:**
+Your agent can't do everything. Now it can ask a human — over MCP, one line:
+`uvx humanbottasks`
+
+**Post 2:**
+Two tools: `request_human_task` and `get_task_status`. That's it. Verification, physical actions, subjective judgment, ground-truth labeling — delegate it to a real person, poll for the result. stdio + streamable-http.
+
+**Post 3:**
+Built this after watching agents confidently assert things they couldn't verify, with no clean handoff for the human parts. Open source, MIT, works with Claude Desktop / Cursor / Windsurf / local agents.
+https://github.com/humanbottasks/humanbottasks
+
+---
+
+## Discord (MCP / LangChain / n8n / Dify servers)
+
+**Kurzer Blurb:**
+> humanbottasks — human fallback for AI agents over MCP. Two tools (request_human_task / get_task_status), stdio + streamable-http, one-line install:
+> `uvx humanbottasks`
+> MIT, works with Claude Desktop/Cursor/Windsurf and local agent frameworks.

humanbottasks-0.1.2/GUIDE.md

@@ -0,0 +1,76 @@
+# Give your AI agent a human fallback — in 2 lines
+
+Agents are great at reasoning, but bad at the parts that need a real person:
+verifying a fact, doing something physical, judging whether something "feels right",
+labeling data correctly. humanbottasks closes that gap with a two-tool MCP server.
+
+## Install
+
+```bash
+uvx humanbottasks
+```
+
+That's it. Add it to your MCP client (Claude Desktop, Cursor, Windsurf) or spawn it
+as a subprocess from any agent framework.
+
+## What you get — two tools
+
+- `request_human_task(task_type, description, max_price_usd)` — delegate work to a real person
+- `get_task_status(task_id)` — poll for the result
+
+## Five task types
+
+| task_type | for things like |
+|---|---|
+| `verification` | check a fact, test a page, confirm a detail |
+| `physical_action` | buy, ship, call, sign, visit |
+| `subjective_judgment` | "does this sound natural?", "is this good enough?" |
+| `ground_truth_labeling` | label data correctly, build eval sets |
+| `prove_human` | CAPTCHA, identity/account verification |
+
+## Example — Claude Desktop
+
+`claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "humanbottasks": {
+      "command": "uvx",
+      "args": ["humanbottasks"]
+    }
+  }
+}
+```
+
+Then ask Claude:
+
+> Check whether https://example.com is reachable from your side, and if it is,
+> what the page title is.
+
+Claude calls `request_human_task(task_type="verification", description="...")`,
+gets a `task_id`, a human fulfills it, and Claude polls `get_task_status` for the result.
+
+## How the loop works
+
+```
+Agent → request_human_task → queue (SQLite) → human fulfills → get_task_status → result
+```
+
+The queue lives at `~/.humanbottasks/tasks.db` (override with `HBT_DB`). Fulfill from the CLI:
+
+```bash
+python fulfill.py done <task_id> "<result>"
+```
+
+## Transports
+
+- `stdio` — Claude Desktop, Cursor, Windsurf, local agent frameworks (default)
+- `streamable-http` — remote agents: `python -m server --transport streamable-http`
+- `sse` — legacy clients
+
+## Links
+
+- Repo: https://github.com/humanbottasks/humanbottasks
+- Landing: https://humanbottasks.github.io/humanbottasks/
+- PyPI: https://pypi.org/project/humanbottasks/

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/LAUNCH_POST.md

@@ -1,33 +1,33 @@
-# Show HN / Launch Post
-
-Fertig zum Einfuegen (Show HN, X, Discord, Reddit r/MCP r/LocalLLaMA).
-
----
-
-**Show HN: humanbottasks — human fallback for AI agents over MCP**
-
-Your agent can't do everything. When it needs to verify a fact, make a phone
-call, buy or ship something, or judge whether text sounds natural, it can now
-delegate that to a real human — over MCP, one line.
-
-Two tools:
-- `request_human_task(type, description, max_price)` — submit a task
-- `get_task_status(task_id)` — poll for the result
-
-Install:
-    uvx --from git+https://github.com/humanbottasks/humanbottasks humanbottasks
-
-Works with Claude Desktop, Cursor, Windsurf (stdio) and remote agents
-(streamable-http). Task types: verification, physical_action,
-subjective_judgment, ground_truth_labeling, prove_human.
-
-Why: models are great at reasoning and bad at anything that touches the
-physical world or needs verified judgment. This is the thinnest possible
-"human in the loop" — no SDK, just MCP, the protocol agents already speak.
-
-I kept hitting the same wall: agents confidently asserting things they
-couldn't verify, with no clean way to hand off the parts only a human can do.
-So I built the handoff. Would love feedback — especially on which task types
-matter most to you.
-
-Repo: https://github.com/humanbottasks/humanbottasks
+# Show HN / Launch Post
+
+Fertig zum Einfuegen (Show HN, X, Discord, Reddit r/MCP r/LocalLLaMA).
+
+---
+
+**Show HN: humanbottasks — human fallback for AI agents over MCP**
+
+Your agent can't do everything. When it needs to verify a fact, make a phone
+call, buy or ship something, or judge whether text sounds natural, it can now
+delegate that to a real human — over MCP, one line.
+
+Two tools:
+- `request_human_task(type, description, max_price)` — submit a task
+- `get_task_status(task_id)` — poll for the result
+
+Install:
+    uvx humanbottasks
+
+Works with Claude Desktop, Cursor, Windsurf (stdio) and remote agents
+(streamable-http). Task types: verification, physical_action,
+subjective_judgment, ground_truth_labeling, prove_human.
+
+Why: models are great at reasoning and bad at anything that touches the
+physical world or needs verified judgment. This is the thinnest possible
+"human in the loop" — no SDK, just MCP, the protocol agents already speak.
+
+I kept hitting the same wall: agents confidently asserting things they
+couldn't verify, with no clean way to hand off the parts only a human can do.
+So I built the handoff. Would love feedback — especially on which task types
+matter most to you.
+
+Repo: https://github.com/humanbottasks/humanbottasks

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: humanbottasks
-Version: 0.1.0
+Version: 0.1.2
 Summary: Human fallback for AI agents: delegate tasks a model can't do to a human, over MCP.
 License-File: LICENSE
 Requires-Python: >=3.10
@@ -9,6 +9,8 @@ Description-Content-Type: text/markdown
 
 # humanbottasks
 
+mcp-name: io.github.humanbottasks/humanbottasks
+
 Gemanagter Human-Service-Layer fuer AI-Agenten. Ein AI-Agent delegiert ueber MCP
 eine Aufgabe, die er nicht selbst kann, an einen Menschen; der Mensch erledigt
 sie, der Agent ruft das Ergebnis ab.
@@ -36,7 +38,10 @@ Host/Port via Umgebungsvariablen: HBT_HOST (default 127.0.0.1), HBT_PORT (defaul
 Fuer Remote-Zugriff: HBT_HOST=0.0.0.0 setzen.
 
 ## Install (fuer andere Builder, 1 Zeile)
-    uvx --from git+https://github.com/humanbottasks/humanbottasks humanbottasks
+    uvx humanbottasks
+
+## Guide (Englisch)
+- [GUIDE.md](GUIDE.md) — Einfuehrung, Task-Typen, Beispiel-Loop, Transports
 
 ## Task-Typen
 verification · physical_action · subjective_judgment · ground_truth_labeling · prove_human

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/README.md

@@ -1,44 +1,49 @@
-# humanbottasks
-
-Gemanagter Human-Service-Layer fuer AI-Agenten. Ein AI-Agent delegiert ueber MCP
-eine Aufgabe, die er nicht selbst kann, an einen Menschen; der Mensch erledigt
-sie, der Agent ruft das Ergebnis ab.
-
-## MVP-Status
-- `server.py`   MCP-Server (Tools: request_human_task, get_task_status)
-- `store.py`    SQLite-Queue (tasks.db)
-- `fulfill.py`  CLI fuer den Menschen (Tasks ansehen/erledigen)
-- `demo.py`     End-to-End-Demo (Agent -> Task -> Mensch -> Ergebnis)
-- `test_smoke.py` Smoke-Test
-
-## Setup & Start
-    cd humanbottasks
-    unset PYTHONPATH
-    uv venv
-    uv pip install "mcp<2"
-    uv run server.py
-
-## Transporte
-    uv run server.py                                  # stdio (Claude Desktop, Cursor, lokale Frameworks)
-    uv run server.py --transport streamable-http      # HTTP-Endpoint http://127.0.0.1:8000/mcp (lokal/Remote-Agents)
-    uv run server.py --transport sse                  # Legacy-SSE http://127.0.0.1:8000/sse
-
-Host/Port via Umgebungsvariablen: HBT_HOST (default 127.0.0.1), HBT_PORT (default 8000).
-Fuer Remote-Zugriff: HBT_HOST=0.0.0.0 setzen.
-
-## Install (fuer andere Builder, 1 Zeile)
-    uvx --from git+https://github.com/humanbottasks/humanbottasks humanbottasks
-
-## Task-Typen
-verification · physical_action · subjective_judgment · ground_truth_labeling · prove_human
-
-## MCP-Clients (installiert + konfiguriert)
-- **Claude Desktop**: `C:\Users\marku\AppData\Roaming\Claude\claude_desktop_config.json`
-- **Cursor**: `C:\Users\marku\.cursor\mcp.json`
-- **Windsurf**: `C:\Users\marku\.codeium\windsurf\mcp_config.json`
-- Templates in `config/` (falls neu einrichten noetig)
-
-## Naechste Schritte (Reihenfolge)
-1. Nachfrage-Test: Server laeuft, ein echter Agent ruft request_human_task.
-2. Website/Landing fuer Agent-Builder.
-3. Payments (Stripe/Circle) erst, wenn Nachfrage da ist.
+# humanbottasks
+
+mcp-name: io.github.humanbottasks/humanbottasks
+
+Gemanagter Human-Service-Layer fuer AI-Agenten. Ein AI-Agent delegiert ueber MCP
+eine Aufgabe, die er nicht selbst kann, an einen Menschen; der Mensch erledigt
+sie, der Agent ruft das Ergebnis ab.
+
+## MVP-Status
+- `server.py`   MCP-Server (Tools: request_human_task, get_task_status)
+- `store.py`    SQLite-Queue (tasks.db)
+- `fulfill.py`  CLI fuer den Menschen (Tasks ansehen/erledigen)
+- `demo.py`     End-to-End-Demo (Agent -> Task -> Mensch -> Ergebnis)
+- `test_smoke.py` Smoke-Test
+
+## Setup & Start
+    cd humanbottasks
+    unset PYTHONPATH
+    uv venv
+    uv pip install "mcp<2"
+    uv run server.py
+
+## Transporte
+    uv run server.py                                  # stdio (Claude Desktop, Cursor, lokale Frameworks)
+    uv run server.py --transport streamable-http      # HTTP-Endpoint http://127.0.0.1:8000/mcp (lokal/Remote-Agents)
+    uv run server.py --transport sse                  # Legacy-SSE http://127.0.0.1:8000/sse
+
+Host/Port via Umgebungsvariablen: HBT_HOST (default 127.0.0.1), HBT_PORT (default 8000).
+Fuer Remote-Zugriff: HBT_HOST=0.0.0.0 setzen.
+
+## Install (fuer andere Builder, 1 Zeile)
+    uvx humanbottasks
+
+## Guide (Englisch)
+- [GUIDE.md](GUIDE.md) — Einfuehrung, Task-Typen, Beispiel-Loop, Transports
+
+## Task-Typen
+verification · physical_action · subjective_judgment · ground_truth_labeling · prove_human
+
+## MCP-Clients (installiert + konfiguriert)
+- **Claude Desktop**: `C:\Users\marku\AppData\Roaming\Claude\claude_desktop_config.json`
+- **Cursor**: `C:\Users\marku\.cursor\mcp.json`
+- **Windsurf**: `C:\Users\marku\.codeium\windsurf\mcp_config.json`
+- Templates in `config/` (falls neu einrichten noetig)
+
+## Naechste Schritte (Reihenfolge)
+1. Nachfrage-Test: Server laeuft, ein echter Agent ruft request_human_task.
+2. Website/Landing fuer Agent-Builder.
+3. Payments (Stripe/Circle) erst, wenn Nachfrage da ist.

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/SUBMISSION.md

@@ -1,44 +1,44 @@
-# humanbottasks — Directory Submission Copy
-
-Fertige Texte fuer MCP-Registries (mcp.so, PulseMCP, glama.ai/mcp, smithery.ai, Cline Marketplace).
-Einfuegen bei Submission; Tagline/Description je nach Feld passend kuerzen.
-
-## Name
-humanbottasks
-
-## Tagline (eine Zeile)
-Human fallback for AI agents — delegate anything a model can't do to a real person, over MCP.
-
-## Description (lang)
-humanbottasks is a managed human-service layer for AI agents. When an agent hits
-something it can't or shouldn't do itself — verify a fact, make a phone call,
-buy or ship something, judge whether text sounds natural, label ground-truth
-data — it delegates the task to a human over MCP and polls for the result.
-
-Two tools: `request_human_task` (submit a task with a type, description and max
-price) and `get_task_status` (poll status and read the result).
-
-Task types: verification, physical_action, subjective_judgment,
-ground_truth_labeling, prove_human.
-
-Transports: stdio (Claude Desktop, Cursor, Windsurf, local frameworks) and
-streamable-http (remote agents).
-
-## Category / Tags
-human-in-the-loop, task-delegation, human-fallback, agent-tools, mcp
-
-## Install
-uvx --from git+https://github.com/humanbottasks/humanbottasks humanbottasks
-
-## MCP client config
-{"mcpServers":{"humanbottasks":{"command":"uvx","args":["--from","git+https://github.com/humanbottasks/humanbottasks","humanbottasks"]}}}
-
-## Use cases (fuer Directory-Description)
-- Prove a claim before the agent states it (verification)
-- Phone calls, purchases, shipments (physical_action)
-- "Does this sound natural / is this good?" (subjective_judgment)
-- Ground-truth data for fine-tuning and evals (ground_truth_labeling)
-- CAPTCHA / account / identity checks (prove_human)
-
-## Repo
-https://github.com/humanbottasks/humanbottasks
+# humanbottasks — Directory Submission Copy
+
+Fertige Texte fuer MCP-Registries (mcp.so, PulseMCP, glama.ai/mcp, smithery.ai, Cline Marketplace).
+Einfuegen bei Submission; Tagline/Description je nach Feld passend kuerzen.
+
+## Name
+humanbottasks
+
+## Tagline (eine Zeile)
+Human fallback for AI agents — delegate anything a model can't do to a real person, over MCP.
+
+## Description (lang)
+humanbottasks is a managed human-service layer for AI agents. When an agent hits
+something it can't or shouldn't do itself — verify a fact, make a phone call,
+buy or ship something, judge whether text sounds natural, label ground-truth
+data — it delegates the task to a human over MCP and polls for the result.
+
+Two tools: `request_human_task` (submit a task with a type, description and max
+price) and `get_task_status` (poll status and read the result).
+
+Task types: verification, physical_action, subjective_judgment,
+ground_truth_labeling, prove_human.
+
+Transports: stdio (Claude Desktop, Cursor, Windsurf, local frameworks) and
+streamable-http (remote agents).
+
+## Category / Tags
+human-in-the-loop, task-delegation, human-fallback, agent-tools, mcp
+
+## Install
+uvx humanbottasks
+
+## MCP client config
+{"mcpServers":{"humanbottasks":{"command":"uvx","args":["humanbottasks"]}}}
+
+## Use cases (fuer Directory-Description)
+- Prove a claim before the agent states it (verification)
+- Phone calls, purchases, shipments (physical_action)
+- "Does this sound natural / is this good?" (subjective_judgment)
+- Ground-truth data for fine-tuning and evals (ground_truth_labeling)
+- CAPTCHA / account / identity checks (prove_human)
+
+## Repo
+https://github.com/humanbottasks/humanbottasks

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/alarm.py

@@ -5,8 +5,8 @@ Wird als no_agent-Cron-Script genutzt: stdout wird verbatim an Telegram geliefer
 import os
 import sqlite3
 
-DB = "C:/Users/marku/humanbottasks/tasks.db"
-STATE = "C:/Users/marku/humanbottasks/data/reported_ids.txt"
+DB = os.environ.get("HBT_DB") or os.path.join(os.path.expanduser("~"), ".humanbottasks", "tasks.db")
+STATE = os.path.join(os.path.expanduser("~"), ".humanbottasks", "reported_ids.txt")
 
 
 def _load():

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/index.html

@@ -1,90 +1,91 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>humanbottasks — Human fallback for AI agents</title>
-<meta name="description" content="Delegate anything your AI agent can't do — verification, physical actions, subjective judgment — to a real human over MCP.">
-<style>
-  :root { --bg:#0a0a0f; --fg:#e8e8f0; --muted:#9a9ab0; --accent:#7c5cff; --accent2:#00d4aa; --card:#14141d; --border:#26263a; }
-  * { margin:0; padding:0; box-sizing:border-box; }
-  body { background:var(--bg); color:var(--fg); font-family:-apple-system,"Segoe UI",Roboto,Helvetica,Arial,sans-serif; line-height:1.6; }
-  a { color:var(--accent2); text-decoration:none; }
-  .wrap { max-width:960px; margin:0 auto; padding:0 24px; }
-  header { padding:32px 0; border-bottom:1px solid var(--border); }
-  .logo { font-weight:800; font-size:20px; letter-spacing:-0.5px; }
-  .logo span { color:var(--accent); }
-  .hero { padding:72px 0 48px; }
-  h1 { font-size:44px; line-height:1.15; letter-spacing:-1px; font-weight:800; }
-  h1 .grad { background:linear-gradient(90deg,var(--accent),var(--accent2)); -webkit-background-clip:text; background-clip:text; color:transparent; }
-  .sub { margin-top:20px; font-size:20px; color:var(--muted); max-width:640px; }
-  .cta { margin-top:32px; display:flex; gap:12px; flex-wrap:wrap; }
-  .btn { padding:12px 24px; border-radius:8px; font-weight:600; font-size:15px; display:inline-block; }
-  .btn-primary { background:var(--accent); color:#fff; }
-  .btn-ghost { border:1px solid var(--border); color:var(--fg); }
-  .grid { display:grid; grid-template-columns:repeat(auto-fit,minmax(260px,1fr)); gap:16px; padding:48px 0; }
-  .card { background:var(--card); border:1px solid var(--border); border-radius:12px; padding:24px; }
-  .card h3 { font-size:17px; margin-bottom:8px; }
-  .card p { color:var(--muted); font-size:15px; }
-  .code { background:var(--card); border:1px solid var(--border); border-radius:12px; padding:20px 24px; font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace; font-size:14px; overflow-x:auto; color:#c9d1ff; margin:24px 0; }
-  .code .c { color:var(--muted); }
-  .steps { padding:32px 0; counter-reset:step; }
-  .step { display:flex; gap:16px; align-items:flex-start; margin-bottom:24px; }
-  .step .n { background:var(--accent); color:#fff; border-radius:50%; width:32px; height:32px; display:flex; align-items:center; justify-content:center; font-weight:700; flex-shrink:0; }
-  .step h4 { margin-bottom:4px; }
-  .step p { color:var(--muted); }
-  .chips { display:flex; flex-wrap:wrap; gap:8px; padding:24px 0 48px; }
-  .chip { border:1px solid var(--border); color:var(--muted); border-radius:999px; padding:6px 14px; font-size:13px; }
-  footer { border-top:1px solid var(--border); padding:32px 0; color:var(--muted); font-size:14px; }
-  .h2 { font-size:28px; letter-spacing:-0.5px; font-weight:700; margin-top:8px; }
-</style>
-</head>
-<body>
-  <header><div class="wrap"><div class="logo">human<span>bot</span>tasks</div></div></header>
-
-  <section class="hero"><div class="wrap">
-    <h1>Your agent can't do everything.<br><span class="grad">Now it can ask a human.</span></h1>
-    <p class="sub">humanbottasks is a managed human-service layer for AI agents. Delegate verification, physical actions and subjective judgment to a real person — over MCP, one line.</p>
-    <div class="cta">
-      <a class="btn btn-primary" href="https://github.com/humanbottasks/humanbottasks">Get started</a>
-      <a class="btn btn-ghost" href="#install">View install</a>
-    </div>
-  </div></section>
-
-  <section class="wrap">
-    <div class="grid">
-      <div class="card"><h3>Delegate anything</h3><p>Verification, phone calls, purchases, data labeling, subjective judgment — whatever the model can't or shouldn't do itself.</p></div>
-      <div class="card"><h3>Standard MCP</h3><p>Works with Claude Desktop, Cursor, Windsurf and any local agent framework. stdio for local, HTTP for remote.</p></div>
-      <div class="card"><h3>You stay in control</h3><p>A real human fulfills the task; your agent polls the result. You set the max price per task.</p></div>
-    </div>
-  </section>
-
-  <section class="wrap" id="install">
-    <div class="h2">Install</div>
-    <div class="code"><span class="c"># one command</span><br>uvx --from git+https://github.com/humanbottasks/humanbottasks humanbottasks</div>
-    <div class="code"><span class="c"># MCP client config (Claude Desktop / Cursor / Windsurf)</span><br>{"mcpServers":{"humanbottasks":{"command":"uvx","args":["--from","git+https://github.com/humanbottasks/humanbottasks","humanbottasks"]}}}</div>
-  </section>
-
-  <section class="wrap">
-    <div class="h2">How it works</div>
-    <div class="steps">
-      <div class="step"><div class="n">1</div><div><h4>Agent delegates</h4><p>The agent calls request_human_task with a description and max price.</p></div></div>
-      <div class="step"><div class="n">2</div><div><h4>Human fulfills</h4><p>A real person does the task and submits the result.</p></div></div>
-      <div class="step"><div class="n">3</div><div><h4>Agent reads the result</h4><p>The agent polls get_task_status and continues with the answer.</p></div></div>
-    </div>
-  </section>
-
-  <section class="wrap">
-    <div class="h2">Task types</div>
-    <div class="chips">
-      <span class="chip">verification</span>
-      <span class="chip">physical_action</span>
-      <span class="chip">subjective_judgment</span>
-      <span class="chip">ground_truth_labeling</span>
-      <span class="chip">prove_human</span>
-    </div>
-  </section>
-
-  <footer><div class="wrap">humanbottasks — human fallback for AI agents. © 2026</div></footer>
-</body>
-</html>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>humanbottasks — Human fallback for AI agents</title>
+<meta name="description" content="Delegate anything your AI agent can't do — verification, physical actions, subjective judgment — to a real human over MCP.">
+<style>
+  :root { --bg:#0a0a0f; --fg:#e8e8f0; --muted:#9a9ab0; --accent:#7c5cff; --accent2:#00d4aa; --card:#14141d; --border:#26263a; }
+  * { margin:0; padding:0; box-sizing:border-box; }
+  body { background:var(--bg); color:var(--fg); font-family:-apple-system,"Segoe UI",Roboto,Helvetica,Arial,sans-serif; line-height:1.6; }
+  a { color:var(--accent2); text-decoration:none; }
+  .wrap { max-width:960px; margin:0 auto; padding:0 24px; }
+  header { padding:32px 0; border-bottom:1px solid var(--border); }
+  .logo { font-weight:800; font-size:20px; letter-spacing:-0.5px; }
+  .logo span { color:var(--accent); }
+  .hero { padding:72px 0 48px; }
+  h1 { font-size:44px; line-height:1.15; letter-spacing:-1px; font-weight:800; }
+  h1 .grad { background:linear-gradient(90deg,var(--accent),var(--accent2)); -webkit-background-clip:text; background-clip:text; color:transparent; }
+  .sub { margin-top:20px; font-size:20px; color:var(--muted); max-width:640px; }
+  .cta { margin-top:32px; display:flex; gap:12px; flex-wrap:wrap; }
+  .btn { padding:12px 24px; border-radius:8px; font-weight:600; font-size:15px; display:inline-block; }
+  .btn-primary { background:var(--accent); color:#fff; }
+  .btn-ghost { border:1px solid var(--border); color:var(--fg); }
+  .grid { display:grid; grid-template-columns:repeat(auto-fit,minmax(260px,1fr)); gap:16px; padding:48px 0; }
+  .card { background:var(--card); border:1px solid var(--border); border-radius:12px; padding:24px; }
+  .card h3 { font-size:17px; margin-bottom:8px; }
+  .card p { color:var(--muted); font-size:15px; }
+  .code { background:var(--card); border:1px solid var(--border); border-radius:12px; padding:20px 24px; font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace; font-size:14px; overflow-x:auto; color:#c9d1ff; margin:24px 0; }
+  .code .c { color:var(--muted); }
+  .steps { padding:32px 0; counter-reset:step; }
+  .step { display:flex; gap:16px; align-items:flex-start; margin-bottom:24px; }
+  .step .n { background:var(--accent); color:#fff; border-radius:50%; width:32px; height:32px; display:flex; align-items:center; justify-content:center; font-weight:700; flex-shrink:0; }
+  .step h4 { margin-bottom:4px; }
+  .step p { color:var(--muted); }
+  .chips { display:flex; flex-wrap:wrap; gap:8px; padding:24px 0 48px; }
+  .chip { border:1px solid var(--border); color:var(--muted); border-radius:999px; padding:6px 14px; font-size:13px; }
+  footer { border-top:1px solid var(--border); padding:32px 0; color:var(--muted); font-size:14px; }
+  .h2 { font-size:28px; letter-spacing:-0.5px; font-weight:700; margin-top:8px; }
+</style>
+</head>
+<body>
+  <header><div class="wrap"><div class="logo">human<span>bot</span>tasks</div></div></header>
+
+  <section class="hero"><div class="wrap">
+    <h1>Your agent can't do everything.<br><span class="grad">Now it can ask a human.</span></h1>
+    <p class="sub">humanbottasks is a managed human-service layer for AI agents. Delegate verification, physical actions and subjective judgment to a real person — over MCP, one line.</p>
+    <div class="cta">
+      <a class="btn btn-primary" href="https://github.com/humanbottasks/humanbottasks">Get started</a>
+      <a class="btn btn-ghost" href="#install">View install</a>
+    </div>
+  </div></section>
+
+  <section class="wrap">
+    <div class="grid">
+      <div class="card"><h3>Delegate anything</h3><p>Verification, phone calls, purchases, data labeling, subjective judgment — whatever the model can't or shouldn't do itself.</p></div>
+      <div class="card"><h3>Standard MCP</h3><p>Works with Claude Desktop, Cursor, Windsurf and any local agent framework. stdio for local, HTTP for remote.</p></div>
+      <div class="card"><h3>You stay in control</h3><p>A real human fulfills the task; your agent polls the result. You set the max price per task.</p></div>
+    </div>
+  </section>
+
+  <section class="wrap" id="install">
+    <div class="h2">Install</div>
+    <div class="code"><span class="c"># one command</span><br>uvx humanbottasks</div>
+    <div class="code"><span class="c"># MCP client config (Claude Desktop / Cursor / Windsurf)</span><br>{"mcpServers":{"humanbottasks":{"command":"uvx","args":["humanbottasks"]}}}</div>
+    <p><a href="https://github.com/humanbottasks/humanbottasks/blob/main/GUIDE.md">Read the full guide →</a></p>
+  </section>
+
+  <section class="wrap">
+    <div class="h2">How it works</div>
+    <div class="steps">
+      <div class="step"><div class="n">1</div><div><h4>Agent delegates</h4><p>The agent calls request_human_task with a description and max price.</p></div></div>
+      <div class="step"><div class="n">2</div><div><h4>Human fulfills</h4><p>A real person does the task and submits the result.</p></div></div>
+      <div class="step"><div class="n">3</div><div><h4>Agent reads the result</h4><p>The agent polls get_task_status and continues with the answer.</p></div></div>
+    </div>
+  </section>
+
+  <section class="wrap">
+    <div class="h2">Task types</div>
+    <div class="chips">
+      <span class="chip">verification</span>
+      <span class="chip">physical_action</span>
+      <span class="chip">subjective_judgment</span>
+      <span class="chip">ground_truth_labeling</span>
+      <span class="chip">prove_human</span>
+    </div>
+  </section>
+
+  <footer><div class="wrap">humanbottasks — human fallback for AI agents. © 2026</div></footer>
+</body>
+</html>

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "humanbottasks"
-version = "0.1.0"
+version = "0.1.2"
 description = "Human fallback for AI agents: delegate tasks a model can't do to a human, over MCP."
 readme = "README.md"
 requires-python = ">=3.10"

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/server.json

@@ -8,13 +8,13 @@
     "url": "https://github.com/humanbottasks/humanbottasks",
     "source": "github"
   },
-  "version": "0.1.0",
+  "version": "0.1.2",
   "packages": [
     {
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "humanbottasks",
-      "version": "0.1.0",
+      "version": "0.1.2",
       "transport": {
         "type": "stdio"
       }

{humanbottasks-0.1.0 → humanbottasks-0.1.2}/store.py

@@ -1,7 +1,8 @@
 """SQLite-Task-Queue fuer humanbottasks (minimales MVP)."""
 import sqlite3, uuid, time, os
 
-DB = os.path.join(os.path.dirname(os.path.abspath(__file__)), "tasks.db")
+_DB_ENV = os.environ.get("HBT_DB")
+DB = _DB_ENV if _DB_ENV else os.path.join(os.path.expanduser("~"), ".humanbottasks", "tasks.db")
 
 
 def _conn():
@@ -11,6 +12,7 @@ def _conn():
 
 
 def init():
+    os.makedirs(os.path.dirname(DB), exist_ok=True)
     with _conn() as c:
         c.execute("""CREATE TABLE IF NOT EXISTS tasks (
             id TEXT PRIMARY KEY,

humanbottasks-0.1.2/test_mcp_client.py

@@ -0,0 +1,58 @@
+"""End-to-End MCP-Protokolltest gegen das gepublishte PyPI-Package.
+
+Simuliert exakt, was ein MCP-Client (Claude Desktop/Cursor) tut:
+  connect -> initialize -> list_tools -> call request_human_task
+  -> (Mensch erfuellt) -> call get_task_status -> Ergebnis.
+
+Der Server wird als `uvx humanbottasks` (PyPI) via stdio gespawnt.
+"""
+import asyncio
+import re
+import sys
+from mcp import ClientSession, StdioServerParameters
+from mcp.client.stdio import stdio_client
+import store as q
+
+
+async def main():
+    # Test gegen das gepublishte PyPI-Package (0.1.1 mit DB-Fix)
+    # --refresh erzwingt Neuaufloesung (sonst greift uvx auf gecachtes 0.1.0 zurueck)
+    params = StdioServerParameters(command="uvx", args=["--refresh", "humanbottasks"])
+    async with stdio_client(params) as (read, write):
+        async with ClientSession(read, write) as session:
+            await session.initialize()
+
+            tools = await session.list_tools()
+            print("=== Tools (via MCP) ===")
+            for t in tools.tools:
+                print(f"  - {t.name}")
+
+            res = await session.call_tool(
+                "request_human_task",
+                arguments={
+                    "task_type": "verification",
+                    "description": "TEST: Pruefe ob die Landing-Page erreichbar ist",
+                    "max_price_usd": 2.0,
+                },
+            )
+            msg = res.content[0].text
+            print("\n=== request_human_task Antwort ===")
+            print(msg)
+
+            tid = re.search(r"task_id=([a-f0-9]+)", msg).group(1)
+            print("task_id:", tid)
+
+            t = q.get_task(tid)
+            print("\n=== DB-Status (sollte pending sein) ===")
+            print(f"  status={t['status']}  typ={t['task_type']}  max=${t['max_price_usd']}")
+
+            q.complete(tid, "OK - HTTP 200, Seite erreichbar")
+            print("\n[Mensch hat erfuellt: 'OK - HTTP 200, Seite erreichbar']")
+
+            res2 = await session.call_tool("get_task_status", arguments={"task_id": tid})
+            print("\n=== get_task_status Antwort ===")
+            print(res2.content[0].text)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())