Runne Documentation
Documentation for the Runne product suite.
Runne Pass
Runne Pass is a managed API for AI models — one API key for OpenAI, Anthropic, DeepSeek, Zhipu AI and Kimi, billed in tokens. During beta the exchange rate is fixed: 1 token = 1 ₽.
- One key for every provider, no per-provider accounts or billing.
- Workspace-scoped billing with a transparent token ledger.
- Balance top-up via YooKassa with 54-ФЗ receipts for individuals.
- OpenAI-compatible
POST /v1/chat/completionsendpoint.
Beta status
Runne Pass is in closed beta. The chat endpoint currently returns a mock provider response — see Chat Completions for the exact behavior.
Runne Engine
Runne Engine is a local-first Rust runtime for AI coding agents. Execution state is durable, completion requires verification evidence, and every dangerous action needs a capability grant.
Documentation for Runne Engine is coming soon — see the Overview.
Guides
| Page | What it covers |
|---|---|
| Introduction | Token model, workspaces, roles, beta status |
| Quickstart | End-to-end curl flow: register → key → chat → balance |
| Authentication | Cookie sessions vs. API keys |
| Workspaces & Balance | Workspace CRUD, ownership, balance |
| API Keys | Key format, scopes, rotation, revocation |
| Payments & YooKassa | Top-up flow, webhooks, receipts |
| Chat Completions | OpenAI-compatible request/response |
| Errors | Status codes and error format |
| Rate Limits & Quotas | Per-key limits, quota enforcement |
Reference
- Endpoints — every method, path, auth mode, and scope.
Knowledge Base
- Architecture — modular monolith, atomic billing, ledger.
- Principles — contracts over claims, verification evidence, capability grants.
- Security — hashing, HMAC, CSRF, session revocation.
- Roadmap — what is ready and what is next.
Runne Engine
- Overview — local-first Rust runtime for AI coding agents.