{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/genie-locker-icon.png\" alt=\"GenieLocker icon\" width=\"160\" height=\"160\">\n</p>\n\n# GenieLocker\n\nGenieLocker gives an AI agent a private OpenAI-compatible Qwen2.5-7B endpoint\nby the minute. The locker is quality-gated before the paid duration begins and\ndestroyed automatically at expiry.\n\n## Current commercial boundary\n\n- One commercial resident SKU: `l16-resident`\n- Prepaid credits: live\n- Direct per-locker x402 settlement: off / fail-closed\n- One completed locker in the public status counter is an operator canary, not\n  a customer\n\nTrust the live API over copied documentation:\n\n```bash\ncurl -s https://genie.locker/api/status\ncurl -s 'https://genie.locker/api/quote?envelope=l16&placement=resident&minutes=10'\n```\n\n## Agent integration\n\n- MCP server: `io.github.nhantour/genie-locker`\n- Full purchase and safety procedure: https://genie.locker/agent.md\n- OpenAPI 3.1: https://genie.locker/openapi.json\n- Machine-readable site index: https://genie.locker/llms.txt\n- Install the agent skill after reviewing the script:\n\n```bash\ncurl -sL https://genie.locker/skill.sh | sh\n```\n\nThe first step can be a free trial credit allocation. No wallet or purchase is\ncreated by reading this repository or installing the skill.\n\n## MCP connector\n\nThe public MCP connector is deliberately read-only. It exposes five tools for\nservice status, commercial inventory, live quotes, recipe search, and credit\npricing. It cannot create accounts, reserve GPUs, buy credits, create lockers,\nor send data to an inference model.\n\nRun it from source:\n\n```bash\nnpm install\nnpm start\n```\n\nOr, after the public image is available:\n\n```bash\ndocker run --rm -i ghcr.io/nhantour/genie-locker-mcp:0.2.0\n```\n\nClient configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"genie-locker\": {\n      \"command\": \"docker\",\n  \"args\": [\"run\", \"--rm\", \"-i\", \"ghcr.io/nhantour/genie-locker-mcp:0.2.0\"]\n    }\n  }\n}\n```\n\nThe connector source in this repository is MIT-licensed under `LICENSE`. The\nprivate broker implementation is not included in this repository or license.\n\n## Genie Guard SDK\n\nThe package also includes a framework-neutral, in-process spend boundary for\nasync JavaScript/TypeScript tools:\n\n```bash\nnpm install https://github.com/nhantour/genie-locker/releases/download/guard-v0.2.0/nhantour-genie-locker-mcp-0.2.0.tgz\n```\n\nIt is also published as `@nhantour/genie-locker-mcp@0.2.0` on GitHub\nPackages for clients already authenticated to `npm.pkg.github.com`.\n\n```js\nimport { createSpendGuard } from '@nhantour/genie-locker-mcp/guard';\nconst guard = createSpendGuard({ limitUsd: 100, perCallLimitUsd: 5 });\nconst safeSearch = guard.wrap(paidSearch, { estimateCostUsd: () => 0.02 });\n```\n\nReservations are counted before the tool starts, so concurrent calls cannot all\npass against the same remaining budget. Failed calls release their reservation;\nsuccessful calls record the estimated cost or an `actualCostUsd` returned by\nyour adapter. Day, UTC-month, and all-time windows are supported.\n\nThis is a local SDK guardrail, not a managed wallet, payment processor, durable\nledger, multi-signature approval system, or substitute for provider-side spend\nlimits. Its state resets with the process. Put the final hard boundary at the\nwallet or payment provider whenever the wrapped tool can move real money.\n\nThe matching Python wheel and source archive are published on the\n[`guard-v0.2.0` GitHub release](https://github.com/nhantour/genie-locker/releases/tag/guard-v0.2.0).\n\nA matching dependency-free Python package lives in [`python/`](python/).\n\nSecurity reports should use the repository's private\n[security advisory form](https://github.com/nhantour/genie-locker/security/advisories/new).\n\n## Minimal flow\n\n```bash\n# 1. Create a trial account and save the returned gk_... key securely.\ncurl -s -X POST https://genie.locker/api/credits/trial\n\n# 2. Request a ten-minute locker with a stable idempotency key.\ncurl -s -X POST https://genie.locker/api/lockers \\\n  -H 'authorization: Bearer gk_REDACTED' \\\n  -H 'idempotency-key: your-stable-order-id' \\\n  -H 'content-type: application/json' \\\n  -d '{\"envelope\":\"l16\",\"placement\":\"resident\",\"minutes\":10}'\n```\n\nThe order is asynchronous. Poll the returned `status_url` with the same API key\nuntil the state is `live`; only then does the paid duration begin.\n\nCopyright © Intelix Systems LLC. This repository documents the public service;\nit does not grant a license to the private broker implementation.\n",
  "bytes": 4456,
  "sha": "1f269f3fee8b81f60a0b3344de59257ded37afd12f1e22fd777ef18cc95f2da8",
  "repo_slug": "nhantour/genie-locker",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nhantour_genie_locker_b5f39e41/readme"
}