Spaces:

waltgrace
/

create-agent-gateway

Running

App Files Files Community

Nico Zahniser commited on Apr 18

Commit

a5112d7

1 Parent(s): ecb06f1

Landing page + README for create-agent-gateway

Browse files

Files changed (2) hide show

README.md +48 -5
index.html +70 -18

README.md CHANGED Viewed

@@ -1,10 +1,53 @@
 ---
-title: Create Agent Gateway
-emoji: ⚡
-colorFrom: indigo
-colorTo: green
 sdk: static
 pinned: false
 ---
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

 ---
+title: create-agent-gateway
+emoji: 🛡️
+colorFrom: purple
+colorTo: pink
 sdk: static
 pinned: false
+license: mit
 ---
+# create-agent-gateway
+A Cloudflare Worker template for pay-per-call agent gateways.
+Bearer-key auth + mcent pricing + x402 signup + scoped keys + XP leaderboard + MCP server — packaged as a scaffolder so anyone can stand up their own agent API in ~2 minutes.
+**Repo:** [github.com/walter-grace/create-agent-gateway](https://github.com/walter-grace/create-agent-gateway)
+**Reference implementation:** [data-label-factory](https://github.com/walter-grace/data-label-factory) — the live gateway using this stack at [data-label-factory.vercel.app/agents](https://data-label-factory.vercel.app/agents).
+## Quickstart
+```bash
+npx create-agent-gateway my-api
+cd my-api
+wrangler kv:namespace create KEYS
+wrangler secret put ADMIN_KEY
+wrangler deploy
+```
+Replace the `/v1/example` handler in `src/index.ts` with your actual paid tool.
+## What's in the box
+- **Bearer-token auth** backed by Workers KV
+- **mcent pricing** (1/1000¢) — sub-cent calls legible + storable as integers
+- **x402 signup** — strangers pay USDC on Base via Coinbase CDP facilitator
+- **Scoped keys** (`crawl`, `label`, `read`, `all`) for tiered access
+- **XP + leaderboard + badges** via a Durable Object (race-free)
+- **Refund policy** with rate cap to block refund-farming
+- **Agent Readiness** well-known routes (`/llms.txt`, `/.well-known/mcp.json`, `/robots.txt` with Content Signals)
+- **MCP server** at `/mcp` — Claude Desktop / Cursor / Zed install in one config block
+## Why
+Agents need:
+1. A way to authenticate — bearer keys beat OAuth dashboards
+2. A balance to draw down — mcents so $0.01 covers 100 calls
+3. A self-serve onramp — x402 so strangers mint keys programmatically
+4. Reputation primitives — XP, levels, badges so markets reward quality
+5. Discoverability — Agent Readiness + MCP so agents find you
+Stripe, OAuth, and dashboards add friction agents can't traverse. This stack skips all of that.

index.html CHANGED Viewed

@@ -1,19 +1,71 @@
-<!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>

+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>create-agent-gateway</title>
+<style>
+  :root { color-scheme: dark; }
+  body { font-family: ui-sans-serif, system-ui, -apple-system, sans-serif; background: #0b0b0c; color: #e5e5e5; margin: 0; padding: 0; line-height: 1.5; }
+  main { max-width: 760px; margin: 0 auto; padding: 3rem 1.5rem; }
+  h1 { font-size: 2.25rem; letter-spacing: -0.02em; margin: 0 0 .25rem; }
+  .tag { color: #a78bfa; font-size: .9rem; text-transform: uppercase; letter-spacing: .12em; }
+  .sub { color: #a1a1aa; margin: .5rem 0 2rem; max-width: 60ch; }
+  .cmd { background: #18181b; border: 1px solid #27272a; border-radius: 10px; padding: 1rem; font-family: ui-monospace, monospace; font-size: .95rem; white-space: pre; overflow-x: auto; }
+  .row { display: flex; gap: .75rem; margin: 1.5rem 0; flex-wrap: wrap; }
+  .btn { display: inline-block; padding: .6rem 1rem; border-radius: 10px; font-size: .9rem; font-weight: 600; text-decoration: none; }
+  .btn-primary { background: #a855f7; color: #fafafa; }
+  .btn-primary:hover { background: #9333ea; }
+  .btn-ghost { background: transparent; border: 1px solid #3f3f46; color: #e5e5e5; }
+  .btn-ghost:hover { border-color: #71717a; }
+  h2 { margin-top: 2.5rem; font-size: 1.25rem; }
+  ul { color: #d4d4d8; padding-left: 1.25rem; }
+  li { margin: .3rem 0; }
+  code { background: #18181b; border: 1px solid #27272a; padding: 1px 6px; border-radius: 4px; font-size: .88em; }
+  .why { background: #18181b; border: 1px solid #27272a; border-radius: 12px; padding: 1.25rem 1.5rem; margin-top: 1.25rem; }
+  .why p { color: #a1a1aa; }
+  footer { margin: 3rem 0 1rem; padding-top: 1.5rem; border-top: 1px solid #27272a; color: #71717a; font-size: .85rem; }
+  a { color: #c4b5fd; }
+</style>
+</head>
+<body>
+<main>
+  <div class="tag">Cloudflare Worker template</div>
+  <h1>create-agent-gateway</h1>
+  <p class="sub">Spin up a pay-per-call agent API in ~2 minutes. Bearer-key auth, mcent pricing, x402 crypto onramp, scoped keys, XP leaderboard, MCP server — all packaged as a scaffolder.</p>
+  <div class="cmd">npx create-agent-gateway my-api
+cd my-api
+wrangler kv:namespace create KEYS
+wrangler secret put ADMIN_KEY
+wrangler deploy</div>
+  <div class="row">
+    <a class="btn btn-primary" href="https://github.com/walter-grace/create-agent-gateway" target="_blank">View on GitHub →</a>
+    <a class="btn btn-ghost" href="https://data-label-factory.vercel.app/how-it-works" target="_blank">See a reference app</a>
+  </div>
+  <h2>What you get</h2>
+  <ul>
+    <li>Bearer-token auth backed by Workers KV</li>
+    <li>mcent pricing (1/1000¢) — sub-cent calls stored as integers</li>
+    <li>x402 signup — strangers pay USDC on Base via Coinbase CDP facilitator</li>
+    <li>Scoped keys (<code>crawl</code>, <code>label</code>, <code>read</code>, <code>all</code>) for tiered access</li>
+    <li>XP + leaderboard + badges via a Durable Object (race-free)</li>
+    <li>Refund policy with rate cap (blocks refund-farming)</li>
+    <li>Agent Readiness well-known routes: <code>/llms.txt</code>, <code>/.well-known/mcp.json</code>, <code>/robots.txt</code> with Content Signals</li>
+    <li>MCP server at <code>/mcp</code> — Claude Desktop / Cursor / Zed install with one config block</li>
+  </ul>
+  <div class="why">
+    <h2 style="margin-top:0;">Why this pattern</h2>
+    <p>Agents need (1) auth — bearer keys beat OAuth dashboards, (2) a balance — mcents so $0.01 buys 100 calls, (3) self-serve onramp — x402 so strangers mint keys programmatically, (4) reputation — XP and badges so the market rewards quality, (5) discoverability — Agent Readiness + MCP so agents find you. Stripe and OAuth add friction agents can't traverse. This stack skips all of that.</p>
+  </div>
+  <h2>Reference implementation</h2>
+  <p>The full production version powers <a href="https://data-label-factory.vercel.app/agents" target="_blank">Data Label Factory</a> — a pay-per-call vision labeling + YOLO training API for agents. Source: <a href="https://github.com/walter-grace/data-label-factory/tree/main/agent-gateway" target="_blank">walter-grace/data-label-factory</a>.</p>
+  <footer>MIT licensed. Built with Cloudflare Workers, Durable Objects, KV, and Coinbase CDP.</footer>
+</main>
+</body>
 </html>