diff --git a/showcase/opencap-gateway/README.md b/showcase/opencap-gateway/README.md new file mode 100644 index 0000000..859bfc2 --- /dev/null +++ b/showcase/opencap-gateway/README.md @@ -0,0 +1,165 @@ +# OpenCAP Gateway + +_One key. Every model. Powered by your staked CAPU — no subscription, no credit card._ + +OpenCAP Gateway is a unified, OpenAI-compatible LLM gateway at `https://gw.capminal.ai`. Instead of +paying a monthly bill, your daily inference is funded by **staked CAPU**: stake it, get a daily +allowance of Inference Credit, create one API key, and point any client, terminal, or agent at a +single endpoint. + +## What It Does + +1. **Log in with your wallet** that holds staked CAPU. +2. **Earn daily Inference Credit** — **$1 of inference per staked CAPU, every day**, renewed at + 00:00 UTC (non-rolling). +3. **Create an `OPENCAP_API_KEY`** from the dashboard. +4. **Point any OpenAI-compatible client** at `https://gw.capminal.ai/api/inference/v1` — usage draws + down your daily Credit automatically, then falls back to a prepaid USDC balance if you top up. + +![OpenCAP Gateway dashboard](https://raw.githubusercontent.com/Capminal/capminal-gitbook/main/.gitbook/assets/opencap_dashboard.png) + +## Mint & Stake CAPU → Daily Inference Credit + +The model separates your **capital** from your **compute** — minting compute never spends your +principal. + +| Asset | What it is | What it does for you | +| -------- | --------------------------------- | --------------------------------------------- | +| **CAP** | The token you already hold | Your capital. You lock it, you never lose it. | +| **sCAP** | A receipt for locking CAP | Proves your CAP is staked, and earns CAP. | +| **CAPU** | The compute asset | Stake it for **$1/day of Inference Credit**. | + +Two ways to get CAPU, then stake it: + +- **Path A — just buy it:** `Buy CAPU → Stake CAPU → $1/day per CAPU`. No CAP required. +- **Path B — lock & mint:** `Stake CAP → sCAP → mint CAPU → Stake CAPU`, earning CAP staking yield + **and** Inference Credit at once. Burn CAPU later to unlock your original CAP. + +```mermaid +flowchart LR + CAP[💎 CAP
your capital] -->|stake| SCAP[sCAP
staking receipt] + SCAP -->|lock & mint| CAPU[⚡ CAPU
compute asset] + BUY([or just buy CAPU]) -.-> CAPU + CAPU -->|stake CAPU| CREDIT[💰 Inference Credit
$1/day per CAPU] + W([👤 Wallet login]) --> KEY[🔑 OPENCAP_API_KEY] + CREDIT -->|funds usage| KEY + KEY --> GW{{OpenCAP Gateway
gw.capminal.ai}} +``` + +> Inference Credit is tied to your **staked** CAPU. Stake more → larger daily allowance. It resets +> daily and does **not** roll over. Full details: the Mint CAPU and Gateway docs linked below. + +## Gateway Providers — powered by Virtuals Compute + +A single `OPENCAP_API_KEY` routes across multiple gateway providers behind one endpoint: + +`virtuals` · `openrouter` · `surplus` · `venice-ai` · **OpeNCAP** (OpenCAP's own infra) + +![Supported models on OpenCAP Gateway](https://raw.githubusercontent.com/Capminal/capminal-gitbook/main/.gitbook/assets/opencap_models.png) + +**Virtuals Compute is an integrated OpenCAP Gateway provider** — and inference capacity from the +**Virtuals program is being used to run OpenCAP Gateway inference**. You can pin providers per +request with a `provider` allow-list; omit it and a combo model picks the cheapest available. + +```mermaid +flowchart LR + KEY[🔑 OPENCAP_API_KEY] --> GW{{OpenCAP Gateway}} + GW --> V[Virtuals Compute] + GW --> OR[OpenRouter] + GW --> S[Surplus] + GW --> VE[Venice] + GW --> OC[OpeNCAP infra] + class V prov; +``` + +## Fund Your Inference + +Both sources fund the same key — daily staking Credit is used first, then a prepaid USDC balance: + +| Funding source | What it is | Best for | +| --------------------------------------- | ------------------------------------------------------ | ------------------------------- | +| **Inference Credit from CAPU staking** | Daily allowance, $1/day per staked CAPU, non-rolling. | Steady, recurring usage. | +| **USDC Top-Up** (via MoonPay) | A prepaid balance that carries over until spent. | Bursts above your daily credit. | + +![USDC Top-Up card](https://raw.githubusercontent.com/Capminal/capminal-gitbook/main/.gitbook/assets/opencap_topup.png) + +## Quick Start + +**Base URL:** `https://gw.capminal.ai/api/inference/v1` + +```bash +export OPENCAP_API_KEY="ocap_..." + +curl https://gw.capminal.ai/api/inference/v1/chat/completions \ + -H "Authorization: Bearer $OPENCAP_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "model": "claude-opus-4.8", + "messages": [{"role": "user", "content": "Hello from OpenCAP"}], + "stream": true + }' +``` + +**Pin providers (optional)** — route only to specific gateways, e.g. Virtuals: + +```bash +curl https://gw.capminal.ai/api/inference/v1/chat/completions \ + -H "Authorization: Bearer $OPENCAP_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "model": "glm-5.2", + "provider": ["surplus", "virtuals"], + "messages": [{"role": "user", "content": "Hello from OpenCAP"}] + }' +``` + +Supported providers: `openrouter`, `surplus`, `virtuals`, `venice-ai`. + +**OpenCode** (`~/.config/opencode/opencode.json`): + +```json +{ + "$schema": "https://opencode.ai/config.json", + "provider": { + "opencap": { + "npm": "@ai-sdk/openai-compatible", + "name": "OpenCAP Gateway", + "options": { + "baseURL": "https://gw.capminal.ai/api/inference/v1", + "apiKey": "{env:OPENCAP_API_KEY}" + }, + "models": { "claude-opus-4.8": { "name": "Claude Opus 4.8" } } + } + } +} +``` + +The gateway also works with **OpenClaw** and **Hermes** using the same base URL and key — see the +OpenCAP Gateway docs for those config snippets. + +> Keep your `OPENCAP_API_KEY` secret — anyone with it can spend your daily Inference Credit. Set a +> per-key daily cap, change expiration, or revoke it anytime from the dashboard. + +## Package Layout + +``` +showcase/opencap-gateway/ + README.md # this file + showcase.json # showcase card manifest +``` + +Screenshots are hosted in the [Capminal docs repo](https://github.com/Capminal/capminal-gitbook) +under `.gitbook/assets/` and linked directly via `raw.githubusercontent.com`. + +## Links + +- **Demo video:** https://x.com/AndreaPN/status/2072571388410638627 +- **Gateway endpoint:** `https://gw.capminal.ai/api/inference/v1` · site: https://capminal.ai +- **Mint CAPU (the model):** https://github.com/Capminal/capminal-gitbook/blob/main/capminal/product-features/mint-capu.md +- **OpenCAP Gateway docs:** https://github.com/Capminal/capminal-gitbook/blob/main/capminal/opencap/gateway.md +- **Builder:** AndreaPN | 404AI Labs — https://www.404ai.io/ + +--- + +_Inference Credit is $1/CAPU/day on the OpenCAP Gateway, renewed daily at 00:00 UTC and +non-accumulating._ diff --git a/showcase/opencap-gateway/showcase.json b/showcase/opencap-gateway/showcase.json new file mode 100644 index 0000000..946c6e1 --- /dev/null +++ b/showcase/opencap-gateway/showcase.json @@ -0,0 +1,72 @@ +{ + "slug": "opencap-gateway", + "title": "OpenCAP Gateway", + "tagline": "Turns staked CAPU into a daily allowance of AI inference across every major model through one OpenAI-compatible gateway, routing over Virtuals Compute, OpenRouter, Surplus, Venice, and OpeNCAP", + "description": "OpenCAP Gateway is a unified, OpenAI-compatible LLM gateway (https://gw.capminal.ai) funded by the Mint & Stake CAPU model instead of a subscription. Lock CAP into sCAP, mint or buy CAPU, then stake it to earn $1/day of Inference Credit per staked CAPU, renewed at 00:00 UTC. One OPENCAP_API_KEY routes requests across multiple gateway providers: Virtuals Compute, OpenRouter, Surplus, Venice, and OpenCAP's own OpeNCAP infra. Virtuals Compute is an integrated gateway provider, and inference capacity from the Virtuals program is used to run OpenCAP Gateway inference. This showcase packages the model explainer, the multi-provider routing story, quick-start client configs (Terminal, OpenClaw, Hermes, OpenCode), and the USDC top-up fallback.", + "status": "live", + "topic": "infra", + "topics": ["compute", "inference", "gateway", "staking", "virtuals", "llm"], + "builder": { + "name": "AndreaPN | 404AI Labs", + "url": "https://www.404ai.io/" + }, + "links": { + "repo": "https://github.com/Virtual-Protocol/acp-cli-demos/tree/main/showcase/opencap-gateway", + "demo": "https://capminal.ai", + "share": "https://x.com/AndreaPN/status/2072571388410638627", + "video": "https://x.com/AndreaPN/status/2072571388410638627", + "feedback": "https://github.com/Virtual-Protocol/acp-cli-demos/issues/new?title=Feedback%3A%20OpenCAP%20Gateway&body=Which%20feedback%20prompt%20fits%3F%0A%0A-%20The%20mint-and-stake%20path%20to%20daily%20inference%20credit%20is%20clear%0A-%20The%20multi-provider%20routing%20needs%20more%20detail%0A-%20I%20want%20a%20client%20setup%20guide%0A%0ANotes%3A%0A" + }, + "primitives": ["wallet", "token"], + "visual": { + "kind": "x demo video", + "eyebrow": "base + virtuals compute + opencap gateway", + "title": "mint & stake CAPU → daily inference credit", + "videoUrl": "https://dackielabs-resources.s3.ap-southeast-1.amazonaws.com/video/VirtualsShowcase.mp4", + "posterUrl": "https://raw.githubusercontent.com/Capminal/capminal-gitbook/main/.gitbook/assets/opencap_dashboard.png", + "videoLabel": "Watch the demo on X" + }, + "skills": [], + "artifacts": [ + { + "label": "X demo video — Virtuals showcase", + "href": "https://x.com/AndreaPN/status/2072571388410638627", + "kind": "video" + }, + { + "label": "OpenCAP Gateway package README", + "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/opencap-gateway/README.md", + "kind": "docs" + }, + { + "label": "Capminal — OpenCAP Gateway home", + "href": "https://capminal.ai", + "kind": "demo" + }, + { + "label": "Mint CAPU — the mint & stake model", + "href": "https://github.com/Capminal/capminal-gitbook/blob/main/capminal/product-features/mint-capu.md", + "kind": "docs" + }, + { + "label": "OpenCAP Gateway docs — one key, every model", + "href": "https://github.com/Capminal/capminal-gitbook/blob/main/capminal/opencap/gateway.md", + "kind": "docs" + }, + { + "label": "Gateway dashboard screenshot", + "href": "https://raw.githubusercontent.com/Capminal/capminal-gitbook/main/.gitbook/assets/opencap_dashboard.png", + "kind": "proof" + }, + { + "label": "Supported models screenshot", + "href": "https://raw.githubusercontent.com/Capminal/capminal-gitbook/main/.gitbook/assets/opencap_models.png", + "kind": "proof" + } + ], + "feedbackPrompts": [ + "Is the mint-and-stake path to daily inference credit clear?", + "Which model provider should the gateway prioritise next?", + "What client setup guide would make adoption easier?" + ] +}