{"_id":"sprotostudio","name":"sprotostudio","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"sprotostudio","version":"0.1.0","description":"Sproto Studio operator agent — multi-chain wallet, MCP tool harness, OpenRouter chat. Plug in OPENROUTER_API_KEY and you have the whole Sproto creation + trading toolset at your fingertips.","license":"MIT","homepage":"https://sproto.studio","bin":{"sproto":"bin/sproto-tui.js","sproto-tui":"bin/sproto-tui.js"},"scripts":{"prepack":"node -e \"const fs=require('node:fs'),p=require('node:path'); function clean(d){if(!fs.existsSync(d))return; for(const e of fs.readdirSync(d)){const f=p.join(d,e); const s=fs.statSync(f); if(s.isDirectory()){ if(e==='__pycache__'){fs.rmSync(f,{recursive:true,force:true});} else {clean(f);} } else if(/\\.pyc$/.test(e)){fs.rmSync(f);}}} clean('sproto_tui');\""},"engines":{"node":">=20"},"dependencies":{"@modelcontextprotocol/sdk":"^1.20.0","@solana/web3.js":"^1.98.0","bs58":"^4.0.1","viem":"^2.30.0","x402":"^1.0.0"},"keywords":["sproto","sprotostudio","bitcoin","harrypotterobamasonic10inu","x402","agent","openrouter","base","solana","mcp","tui"],"_id":"sprotostudio@0.1.0","gitHead":"5a7c3613005a0d14857f73452e97e7d188e5cd47","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-HwcjZcNwfbw+GetzHVXmzbtktjKLl+BPItdzOag/IfjcmCmz+5tZRchoededwCQqJDJX2io4pLTY+11xhcPXQw==","shasum":"122f058bb5a32c34db6254eb70f25684c5e30452","tarball":"https://registry.npmjs.org/sprotostudio/-/sprotostudio-0.1.0.tgz","fileCount":17,"unpackedSize":115147,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEbfltUZeQhAFnpyJgrwQK744u+nfjeUVj2aYZqFDe95AiEAtQQc9HcZQchqRF5qQ7Pj2dRix/t4JAMlLsWTxTGSBrs="}]},"_npmUser":{"name":"bitcoinaqua","email":"store2222222real@gmail.com"},"directories":{},"maintainers":[{"name":"bitcoinaqua","email":"store2222222real@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sprotostudio_0.1.0_1777748005340_0.78054938326901"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-02T18:53:25.266Z","0.1.0":"2026-05-02T18:53:25.478Z","modified":"2026-05-02T18:53:25.717Z"},"maintainers":[{"name":"bitcoinaqua","email":"store2222222real@gmail.com"}],"description":"Sproto Studio operator agent — multi-chain wallet, MCP tool harness, OpenRouter chat. Plug in OPENROUTER_API_KEY and you have the whole Sproto creation + trading toolset at your fingertips.","homepage":"https://sproto.studio","keywords":["sproto","sprotostudio","bitcoin","harrypotterobamasonic10inu","x402","agent","openrouter","base","solana","mcp","tui"],"license":"MIT","readme":"# sproto\n\nOperator agent for Sproto Studio. One install gives you:\n\n- A multi-chain wallet (Base EVM + Solana) auto-provisioned on first run.\n- The full Sproto Studio MCP tool catalog — image, video, music, 3D, NFT lookups, trading.\n- An OpenRouter-backed chat agent that can call any of those tools on your behalf.\n- Native x402 payments — paid tools settle in USDC or $BITCOIN from your wallet.\n\n## Install\n\n### Via npm (one-liner)\n\n```bash\nnpm install -g sproto\n```\n\nThis bundles the Python TUI source plus the Node sidecars (viem, x402,\n@solana/web3.js). On first run the launcher creates an isolated Python\nvenv at `~/.sprotostudio/venv` and installs the package into it.\n\nRequires Python ≥ 3.11 on PATH (the launcher tells you where to grab it\nif it's missing). Node ≥ 20.\n\n### Via pipx (Python-native)\n\n```bash\npipx install sprotostudio\n```\n\nThe PyPI name stays `sprotostudio` because `sproto` is taken on PyPI by\nan unrelated package. You'll also need Node ≥ 20 in scope so the\nwallet/x402 sidecars run.\n\n### Run\n\n```bash\nsproto              # launches the Textual TUI\nsproto doctor       # check transports, wallet, x402, balances\nsproto wallet       # show wallet addresses + on-chain balances\nsproto fund         # print funding instructions\nsproto agent \"...\"  # one-shot agent prompt (needs OPENROUTER_API_KEY)\nsproto agent        # interactive agent chat\n```\n\n`sproto-tui` is kept as an alias of `sproto` for backwards compatibility.\n\n## Wallet\n\nFirst-run creates `~/.config/sproto-tui/wallet.json` containing:\n\n- a Base/EVM private key (for x402 payments and any EVM trading)\n- a Solana keypair encoded as `secretBase58` (Phantom-importable)\n\nThe file is written with mode 600. Back it up — losing it loses the\nfunds, and there's no recovery flow yet.\n\n## Paying for tools\n\nFree tools (catalog, lookups, status polls) cost nothing. Paid tools\nreturn a 402 challenge listing accepted assets. The TUI's signer prefers\nUSDC on Base by default; flip rails per call:\n\n```bash\nSPROTO_TUI_PAY_ASSET=bitcoin sproto call sproto_create_image --arg prompt=\"...\"\nSPROTO_TUI_PAY_ASSET=usdc    sproto call sproto_create_image --arg prompt=\"...\"\n```\n\nRun `sproto fund` for the bridge + swap links to fund either\nchain.\n\n## Agent harness\n\n```bash\nexport OPENROUTER_API_KEY=sk-...\nsproto agent \"make a sproto wearing sunglasses and post the URL\"\n```\n\nThe agent gets a system prompt with your wallet addresses + live\nbalances + the entire MCP tool catalog as OpenAI-style functions. It\nplans, calls tools, and reports results. Costs (USDC or $BITCOIN) come\nout of the local wallet.\n\nSet `SPROTO_AGENT_MODEL` to override the default model\n(`openrouter/owl-alpha`). Any OpenRouter model with tool-calling\nsupport works.\n\n## Environment variables\n\n| Var | Purpose |\n| --- | ------- |\n| `OPENROUTER_API_KEY`     | Required for `agent`. Get one at https://openrouter.ai/keys. |\n| `SPROTO_AGENT_MODEL`     | Override the default agent model. |\n| `SPROTO_API_TOKEN`       | Optional bearer token for sproto.studio (credits-based runs). |\n| `SPROTO_STUDIO_API`      | Override the API base URL (default https://sproto.studio). |\n| `SPROTO_TUI_TRANSPORT`   | `auto` (default), `mcp`, or `http`. |\n| `SPROTO_TUI_PAY_ASSET`   | `usdc` (default) or `bitcoin`. |\n| `SPROTO_TUI_FORCE_X402`  | `1` to drop the bearer and force the x402 path. |\n| `AGENT_WALLET_KEY`       | Override the auto-wallet's private key. |\n| `SOLANA_RPC_URL`         | Custom Solana RPC for balance reads. |\n| `SPROTO_TUI_PYTHON`      | npm launcher: pin a specific Python interpreter. |\n| `SPROTO_TUI_HOME`        | npm launcher: override the venv location (default `~/.sprotostudio`). |\n","readmeFilename":"README.md","_rev":"1-05de855f21b85a7cf7fa2acbe1c7f615"}