# Tonbo > Cloud for you and your agents. Compute, disks, databases and streams for AI agents. Your agent picks what it needs, sets it up, and knows what it costs. $5 free every month. [Machines](https://tonbo.dev/docs/machines.md) are a computer for your agent or service: one sleeps when idle, and you pay only for the CPU it uses and the memory it holds. [Volumes](https://tonbo.dev/docs/machines/guarantees/data/volume.md) are a disk that outlives the Machine, billed by the bytes it holds. [Databases](https://tonbo.dev/docs/databases.md) are SQLite you open by name from any machine, at local speed. [Streams](https://tonbo.dev/docs/streams.md) are durable logs at a URL: append exactly once, read from any offset. The [Management API](https://tonbo.dev/docs/reference/management.md) is every operation over REST, the same API the CLI calls. [Durable agents](https://tonbo.dev/docs/getting-started/quickstarts/pi.md) run any harness, outliving the machine it runs on: pause one, resume it anywhere. These docs describe @tonbo/sdk 1.1.0 with @tonbo/sqlite-ursula 0.11.4 for Node.js (install those exact versions), sqlite-ursula 0.11.6 for Python, and the CLI @tonbo/cli 0.36.1. Tonbo is made by Tonbo IO, Inc. Its home page https://tonbo.io links here, its code is at https://github.com/tonbo-io (whose listed website is tonbo.io), and its packages are published under the @tonbo npm scope. Each https://tonbo.dev link below is a page as Markdown; the same URL without .md is the page for people. Every page in one file: https://tonbo.dev/llms-full.txt, or the same pages by product under Full text. - [Tonbo Documentation](https://tonbo.dev/docs.md): the docs home, with the agent prompt and the quickstarts. ## Start - Install the CLI: `npm i -g @tonbo/cli@^0.36` - Sign in: `tonbo login` - Follow a quickstart: [A computer for your agent (Machine)](https://tonbo.dev/docs/getting-started/quickstarts/agent-machine.md) ## Pricing - [Pricing](https://tonbo.dev/pricing.md): every price, the plans and the free usage. ## API - [OpenAPI document](https://api.tonbo.dev/v1/openapi.json): the Management API. - [Management API](https://tonbo.dev/docs/reference/management.md): The API at api.tonbo.dev: authentication, roles, error codes, pagination, idempotency, and every operation. - [CLI reference](https://tonbo.dev/docs/reference/cli.md): Every command of the tonbo CLI: its flags and defaults, the operation it calls, its --json output and an example. ## Open source - [Ursula](https://github.com/tonbo-io/ursula): the stream engine under Databases and Streams, Apache-2.0. Docs: https://ursula.tonbo.io/docs - [GitHub](https://github.com/tonbo-io): every Tonbo repository. ## Company - Tonbo IO Inc.: [tonbo.io](https://tonbo.io), contact@tonbo.io - [Discord](https://discord.gg/j27XVFVmJM) - [Terms of Service](https://tonbo.dev/terms), [Privacy Policy](https://tonbo.dev/privacy), [Acceptable Use Policy](https://tonbo.dev/acceptable-use) ## Full text - [Every page](https://tonbo.dev/llms-full.txt): every page below in one file. - [Getting started](https://tonbo.dev/docs/llms-full/start.txt): The docs home, what Tonbo is, when it fits, and every quickstart. - [Durable agents](https://tonbo.dev/docs/llms-full/agents.txt): Pi Durable, a computer for your agent, a database per run, side effects, and the Pi and LangGraph references. - [Machines](https://tonbo.dev/docs/llms-full/machines.txt): Machines: concepts, quickstarts, images, requests, sleep, deploys, the rules, and the work inside a Machine. - [Operating Machines](https://tonbo.dev/docs/llms-full/machines-operate.txt): Managing and troubleshooting Machines, their limits and pricing, and what they guarantee. - [Volumes](https://tonbo.dev/docs/llms-full/volumes.txt): A Machine’s Volume: what it is, how it behaves, keeping data on it or making it the whole disk, its rules, limits and speed, its refusals, and the Management API’s Volumes operations. - [Databases](https://tonbo.dev/docs/llms-full/databases.txt): Databases: concepts, quickstarts, connecting from Node.js and Python, the rules, operating them, limits, pricing and how they work. - [Streams](https://tonbo.dev/docs/llms-full/streams.txt): Streams: concepts, the quickstart, appending, reading, snapshots, job progress, access, operating them, limits, pricing and guarantees. - [Internals](https://tonbo.dev/docs/llms-full/internals.txt): How Databases, Streams and Machines work inside: the extension, replication, Ursula, the microVM, isolation, metering and how Machines’ data is encrypted. - [Account](https://tonbo.dev/docs/llms-full/account.txt): Accounts, members and roles, Agents, API keys and tokens, regions, how they fit together, how your data is protected, rotating a key, a member leaving, deleting your account, and the Management API’s account and API keys operations. - [Billing](https://tonbo.dev/docs/llms-full/billing.txt): Usage and billing, spend budgets, giving an Agent a budget, and the Management API’s usage and budgets operations. - [Management API](https://tonbo.dev/docs/llms-full/api.txt): The reference overview, the Management API’s conventions, and its databases operations. - [Management API: Streams](https://tonbo.dev/docs/llms-full/api-streams.txt): The Management API’s streams operations. - [Streams HTTP and the token exchange](https://tonbo.dev/docs/llms-full/streams-http.txt): Every request a stream’s URL serves, and the token exchange that mints stream tokens. - [Node.js SDK](https://tonbo.dev/docs/llms-full/sdk-nodejs.txt): Every export of the Node.js packages, page by page. - [Python SDK](https://tonbo.dev/docs/llms-full/sdk-python.txt): Every export of the Python package, page by page. - [CLI](https://tonbo.dev/docs/llms-full/cli.txt): Every tonbo command and flag. Too large for any part, and its own page only: [Management API: Machines](https://tonbo.dev/docs/reference/management/machines.md). ## Getting started - [Getting started overview](https://tonbo.dev/docs/getting-started.md): What Tonbo is, how your code reaches it, what it costs, and the quickstarts. - [A computer for your agent (Machine)](https://tonbo.dev/docs/getting-started/quickstarts/agent-machine.md): Give an agent a Machine to work on: it runs the agent’s commands, keeps the work on a Volume, sleeps between tasks and lets you open a terminal in it. - [Pi Durable](https://tonbo.dev/docs/getting-started/quickstarts/pi.md): Pi Durable, an open-source agent harness, keeping its conversation in a database another machine resumes. - [SQLite/Node.js](https://tonbo.dev/docs/getting-started/quickstarts/sqlite.md): From sign-in to a first commit with node:sqlite on a replicated database. - [SQLite/Python](https://tonbo.dev/docs/getting-started/quickstarts/sqlite-python.md): From sign-in to a first commit with Python’s sqlite3 on a replicated database. - [Drizzle ORM](https://tonbo.dev/docs/getting-started/quickstarts/drizzle.md): From sign-in to a first Drizzle query on a replicated database. - [Durable stream (HTTP)](https://tonbo.dev/docs/getting-started/quickstarts/stream.md): Create a stream, then append to it, read it, tail it and close it with curl. - [HTTPS service (Machine)](https://tonbo.dev/docs/getting-started/quickstarts/machine.md): Run a public image as an HTTPS service, call it, put it to sleep and wake it, from your laptop. ## Databases - [Databases](https://tonbo.dev/docs/databases.md): SQLite databases your program opens by name from any machine: local speed, and they outlive the machine. - [Connect from Node.js](https://tonbo.dev/docs/databases/connect.md): What the host needs, then open a database by name or URL: the key, synced(), connections and status. - [Connect from Python](https://tonbo.dev/docs/databases/python.md): What your Python needs, then open a database by its URL: the key, synced(), asyncio, frameworks and LangGraph. - [Use with Drizzle](https://tonbo.dev/docs/databases/drizzle.md): Drizzle in depth: why migrations run in the app, synced(), transactions and rollbacks. - [One database per agent run](https://tonbo.dev/docs/databases/per-run.md): Create a database for each run, give its sandbox a narrowed key, sync before exit, and delete it after. - [Run side effects once](https://tonbo.dev/docs/databases/side-effects.md): Record an email, a payment or an API call before making it, so a crash, a restart or a second instance does not repeat it. - [Manage databases](https://tonbo.dev/docs/databases/manage.md): Create, list, publish and delete databases in the console, the CLI or the API, in a region you pick. - [Backups](https://tonbo.dev/docs/databases/backups.md): Export a plain SQLite copy to move a database or undo a mistake, and find the copies an open moved aside. - [Rules for databases](https://tonbo.dev/docs/databases/rules.md): Every rule that keeps data safe, one writer in charge and the bill small, linking to its page. - [Rules: persist, then act](https://tonbo.dev/docs/databases/rules/persist.md): Await synced() before anything outside acts, let gate() hold an answer, record a side effect first, bound a wait. - [Rules: one writer](https://tonbo.dev/docs/databases/rules/one-writer.md): One instance per database, stop when a reset says so, and keep the cache directory. - [Rules: size and cost](https://tonbo.dev/docs/databases/rules/cost.md): Batch a step’s writes, write what changed, and keep a transaction under the limit. - [Rules: SQLite](https://tonbo.dev/docs/databases/rules/sqlite.md): Leave the journal mode and the page size alone, and reach the data only through open(). - [Rules: setup](https://tonbo.dev/docs/databases/rules/setup.md): Create before you open, narrow each key, pick the region, and export a plain copy. - [Troubleshooting](https://tonbo.dev/docs/databases/troubleshooting.md): What you see when a database misbehaves, and the fix for each; then a page each for opening, resets, refused writes and managing databases. - [Troubleshooting: opening](https://tonbo.dev/docs/databases/troubleshooting/open.md): When open() fails or every request is refused: the database, the key or the lookup. - [Troubleshooting: resets](https://tonbo.dev/docs/databases/troubleshooting/reset.md): When the package resets a database, and when another process writes it now. - [Troubleshooting: refused writes](https://tonbo.dev/docs/databases/troubleshooting/writes.md): When Tonbo refuses commits: the balance, access, a large transaction, a full backlog. - [Troubleshooting: managing databases](https://tonbo.dev/docs/databases/troubleshooting/manage.md): Each refusal a create, change or delete of a database can get, and what to do. - [Limits](https://tonbo.dev/docs/databases/limits.md): How large a database can grow, the account’s request rate, and what one transaction and one host can take. - [Pricing](https://tonbo.dev/docs/databases/pricing.md): Writes, storage, the monthly allowance, three worked examples, and what happens when the balance runs out. - [Guarantees](https://tonbo.dev/docs/databases/how-it-works.md): A commit is durable once synced() resolves; what happens when the program moves, runs twice or goes offline, and two shells that show a second instance taking over. - [Durability](https://tonbo.dev/docs/databases/durability.md): Three replicas in three zones of each region, maintenance one replica at a time, and which releases work together. - [Concepts](https://tonbo.dev/docs/databases/concepts.md): A database is SQLite on your disk that Tonbo holds. Then its local copy, a commit and synced(), the writer, the region, keys, and what Tonbo keeps. - [Concepts: Pi Durable](https://tonbo.dev/docs/databases/pi-durable.md): A Pi Durable conversation on a database: what it keeps, how another machine resumes it, and its one writer. - [Cold starts](https://tonbo.dev/docs/databases/cold-starts.md): An open on a new host rebuilds the database from Tonbo: how long that takes, and how to avoid it. - [The SQLite extension](https://tonbo.dev/docs/databases/internals/sqlite-extension.md): The VFS, what a commit writes on the host, the cache root and generations, WAL and 4 KiB pages. - [Replication and synced()](https://tonbo.dev/docs/databases/internals/replication.md): How commits reach the stream, retries, what synced() waits for, and the backlog. - [Ownership and fencing](https://tonbo.dev/docs/databases/internals/ownership.md): Producer epochs and claims: how the last open becomes the only writer. - [Ursula in Tonbo](https://tonbo.dev/docs/databases/internals/ursula.md): The server behind databases and streams: three voters per region, the gateway, the quorum, restarts and fsync. - [Snapshots and S3](https://tonbo.dev/docs/databases/internals/snapshots.md): When snapshots are published, how a cold open reads them, and what S3 holds. ## Streams - [Streams](https://tonbo.dev/docs/streams.md): Durable logs at HTTPS URLs: append exactly once, read from any offset, tail them live. - [Append](https://tonbo.dev/docs/streams/append.md): Append exactly once, content types and JSON mode, batches, conditional appends and closing. - [Read and tail](https://tonbo.dev/docs/streams/read.md): Read from any offset, long-poll and SSE tails, HEAD, a recreated stream, and reads you can cache. - [Snapshots and retention](https://tonbo.dev/docs/streams/snapshots.md): Publish a summary new readers start from, stop keeping the history before it, and bootstrap. - [Job progress to a web UI](https://tonbo.dev/docs/streams/job-progress.md): Lay out streams for job progress kept about 90 days, relay a live tail to a page, and size and price it. - [Manage streams](https://tonbo.dev/docs/streams/manage.md): Create, list, publish, expire and delete streams in the console, the CLI or the API. - [Access](https://tonbo.dev/docs/streams/access.md): The key or token every request carries, a token for a web page, keys narrowed to streams, and public streams anyone can read. - [Rules for streams](https://tonbo.dev/docs/streams/rules.md): Every rule for writers, readers and keys, linking to its page with what to send and what not to. - [Rules: writers](https://tonbo.dev/docs/streams/rules/writers.md): Producer headers, the same request again, one producer id per writer, batches, and closing. - [Rules: readers](https://tonbo.dev/docs/streams/rules/readers.md): Offsets as given, reading to the end, a saved offset, a reopened tail, and retention. - [Rules: keys and errors](https://tonbo.dev/docs/streams/rules/keys.md): Exchange an Agent’s key, narrow each key, tokens for web pages, and match the code. - [Troubleshooting](https://tonbo.dev/docs/streams/troubleshooting.md): Each refusal a stream or the Management API gives, and the fix for each; then a page each for stream requests and the Management API. - [Troubleshooting: stream requests](https://tonbo.dev/docs/streams/troubleshooting/stream.md): Each refusal at a stream’s URL, whether to send it again, and what to do. - [Troubleshooting: Management API](https://tonbo.dev/docs/streams/troubleshooting/api.md): Each refusal when you create, change or delete a stream, and what to do. - [Limits](https://tonbo.dev/docs/streams/limits.md): The account’s request rate and open tails, 8 MiB per append and per read, and what one stream can take. - [Pricing](https://tonbo.dev/docs/streams/pricing.md): Writes and storage, free reads, usage per stream, and three worked examples. - [Delivery guarantees](https://tonbo.dev/docs/streams/guarantees.md): When an append is durable, exactly-once appends, one order, what readers see, and each answer. - [Concepts](https://tonbo.dev/docs/streams/concepts.md): A stream is an append-only log at an HTTPS URL. Then its messages and offsets, producers, tails, closing, snapshots, retention, and every operation. ## Machines - [Machines](https://tonbo.dev/docs/machines.md): HTTP and WebSocket services from your own image that sleep when idle, keeping what lasts on a Volume or in a Tonbo database. - [Run your own image](https://tonbo.dev/docs/machines/images.md): Build and publish an image, run it with your command and env, and what it finds inside. - [Serve requests](https://tonbo.dev/docs/machines/requests.md): Ports at the Machine’s name, private and public, what a request carries, and the first request after a sleep. - [Keep data on a Volume or in a database](https://tonbo.dev/docs/machines/database.md): Choose between a Volume and a Tonbo database, bind a database or open one by URL, answer after synced() and stop cleanly. - [Keep a Machine’s whole disk](https://tonbo.dev/docs/machines/whole-disk.md): Make a Volume the Machine’s whole disk, so installed packages and every file outside the scratch paths last across sleeps, and change its image with a Rebuild. - [Sleep, wake and stop](https://tonbo.dev/docs/machines/sleep.md): Wake a Machine before a request reaches it, keep it awake for work with no request open, and put it to sleep, which stops your program. - [Deploy a change](https://tonbo.dev/docs/machines/deploy.md): A change applies at the next wake: how to apply it now, and a new image under the same tag. - [Receive webhooks](https://tonbo.dev/docs/machines/webhooks.md): A public port that checks each event’s signature, records it in the database and answers after synced(). - [Run GitHub Actions jobs](https://tonbo.dev/docs/machines/github-actions.md): Run your CI on a Machine that sleeps between jobs: one command with a prebuilt image and a GitHub token, and each queued job wakes it. - [Run commands](https://tonbo.dev/docs/machines/exec.md): Run one command in a Machine over HTTPS and get its output and exit status in the answer. - [Background processes](https://tonbo.dev/docs/machines/processes.md): Start work that outlives your call with exec --detach, then read its output, wait for it or stop it. - [Keep it awake with holds](https://tonbo.dev/docs/machines/holds.md): Keep an awake Machine awake between calls, from outside or from a program inside it, and what that costs. - [Read and write files](https://tonbo.dev/docs/machines/files.md): Read, write, list, move and delete a Machine’s files over HTTPS, and which of them last past a sleep. - [Connect with SSH](https://tonbo.dev/docs/machines/ssh.md): Open a terminal in a Machine, or connect an editor, with a short-lived certificate and no keys to register. - [Read its logs](https://tonbo.dev/docs/machines/logs.md) (planned): What your program printed and what Tonbo did to the Machine, read or followed across sleeps and wakes. - [Volumes overview](https://tonbo.dev/docs/machines/volumes.md): A disk of your account that one Machine mounts and that lasts across its sleeps: what to keep on it, what to keep in a database, and how it relates to a Machine. - [How Volumes work](https://tonbo.dev/docs/machines/volumes/how-it-works.md): Why a Volume keeps its data on its server’s disk and copies it to the region’s storage, what that means for your program, and why a wake on another server reads slower at first. - [Things to know](https://tonbo.dev/docs/machines/volumes/things-to-know.md): One Machine and one region per Volume, moving and deleting one, what it costs, how large it can be, and what a Volume does not do. - [Performance](https://tonbo.dev/docs/machines/volumes/performance.md): What each shape lets a Volume read and write, how to see a Machine reach that limit, and the slower first reads after a wake on another server. - [Troubleshooting: Volumes](https://tonbo.dev/docs/machines/volumes/troubleshooting.md): Each refusal a Volume’s create, binding, move or delete can get, and what you may see while one is in use, with what to do. - [Manage Machines](https://tonbo.dev/docs/machines/manage.md): Create, list, show, change, put to sleep and delete Machines with the CLI or the API, in a region you pick. - [Rules for Machines](https://tonbo.dev/docs/machines/rules.md): Every rule for state, requests, images and access, linking to its page with what to do and what not to. - [Rules: keep state](https://tonbo.dev/docs/machines/rules/state.md): Keep what must last in the database, reconnect after a wake, answer after synced(), and stop cleanly. - [Rules: requests](https://tonbo.dev/docs/machines/rules/requests.md): Listen where Tonbo connects, start fast, keep ports private, and retry a 503. - [Rules: images and changes](https://tonbo.dev/docs/machines/rules/images.md): The smallest shape, your own image built for arm64, a glibc image, a tag named again, and a change applied now. - [Rules: access](https://tonbo.dev/docs/machines/rules/access.md): What env may hold, no secret in the image, and your own credentials with other services. - [Troubleshooting](https://tonbo.dev/docs/machines/troubleshooting.md): The most common refusals and surprises, and the fix for each; then a page each for calling a Machine, symptoms and managing Machines. - [Troubleshooting: calling a Machine](https://tonbo.dev/docs/machines/troubleshooting/call.md): Each refusal a request to a Machine can get, why, and what to do. - [Troubleshooting: symptoms](https://tonbo.dev/docs/machines/troubleshooting/symptoms.md): What a Machine does that you did not expect, with no refusal to go by. - [Troubleshooting: managing Machines](https://tonbo.dev/docs/machines/troubleshooting/manage.md): Each refusal a create, change or delete can get, why, and what to do. - [Limits](https://tonbo.dev/docs/machines/limits.md): What one Machine’s shape gives it, its open requests, and the bounds of a wake, an image, a database it binds and one account, and what a Machine does not offer. - [Pricing](https://tonbo.dev/docs/machines/pricing.md): What an awake Machine is charged for, each shape’s ceiling, what it keeps while asleep, the credit a wake needs, and what three designs cost. - [Worked examples](https://tonbo.dev/docs/machines/pricing/examples.md): Three designs priced two ways for a month: a Machine per agent, a private port, and state kept in a database. - [Guarantees](https://tonbo.dev/docs/machines/guarantees.md): What you can rely on, one line per topic: your data, a sleep, requests, isolation and the network. - [Sleep guarantees](https://tonbo.dev/docs/machines/guarantees/sleep.md): When a Machine sleeps and wakes, what comes back, and its Volume and database across a sleep. - [Request guarantees](https://tonbo.dev/docs/machines/guarantees/requests.md): A request runs at most once, how long a wake waits for a host, and the credit a wake needs. - [Isolation guarantees](https://tonbo.dev/docs/machines/guarantees/isolation.md): What no other Machine can read or take from yours, and what is not claimed. - [Network guarantees](https://tonbo.dev/docs/machines/guarantees/network.md): What can reach a Machine, what it can reach, and what is always blocked. - [In a database](https://tonbo.dev/docs/machines/guarantees/data.md): When a commit to a database the Machine binds is durable, what a crash can lose, and how much it holds. - [On a Volume](https://tonbo.dev/docs/machines/guarantees/data/volume.md): What a write to the Machine’s Volume survives: a crash, the loss of its server or zone, and a sleep. - [Concepts](https://tonbo.dev/docs/machines/concepts.md): A Machine is your container image, run by Tonbo at an HTTPS name. Then its ports, awake and asleep, a wake, its shape, its Volume, a database it binds and its image. - [The microVM](https://tonbo.dev/docs/machines/internals/microvm.md): Firecracker under its jailer on a metal host: one virtual machine per wake, its drives, its boot and its stop. - [Isolation claims](https://tonbo.dev/docs/machines/internals/isolation.md): Tonbo’s isolation claims for Machines word for word, what is not claimed, and the mechanism behind each. - [Network path](https://tonbo.dev/docs/machines/internals/network.md): The edge that takes a Machine’s HTTPS, the tunnel to its host, and the NAT and deny list its connections pass. - [Activations](https://tonbo.dev/docs/machines/internals/activations.md): How a request wakes a Machine: admission, the hold, activity, release, crash backoff and the drain. - [Image pulls](https://tonbo.dev/docs/machines/internals/image-pulls.md): How a reference becomes a digest, how a host pulls and flattens an image, and the limits it checks. - [Metering and holds](https://tonbo.dev/docs/machines/internals/metering.md): What the host measures while a Machine is awake, how ten-minute holds turn it into a charge, and a Volume’s storage. - [Database wiring](https://tonbo.dev/docs/machines/internals/database.md): Where a database a Machine binds lives, how the Machine gets its token, the platform’s limits and the drain. ## Reference - [Reference overview](https://tonbo.dev/docs/reference.md): Every module Tonbo serves, where it answers and the credential it takes, and the conventions they share. - [Management API overview](https://tonbo.dev/docs/reference/management.md): The API at api.tonbo.dev: authentication, roles, error codes, pagination, idempotency, and every operation. - [Account](https://tonbo.dev/docs/reference/management/account.md): Read the account, its regions and members, change a member's role, create an Agent. - [API keys](https://tonbo.dev/docs/reference/management/api-keys.md): Create, list, read and revoke the account's keys, and narrow a key. - [Databases](https://tonbo.dev/docs/reference/management/databases.md): Create, list, read, publish and delete databases. - [Streams](https://tonbo.dev/docs/reference/management/streams.md): Create, list, read, publish and delete streams. - [Usage](https://tonbo.dev/docs/reference/management/usage.md): The account's usage of a month, and each database's and stream's, at list price. - [Budgets](https://tonbo.dev/docs/reference/management/budgets.md): List, read and create the account's monthly spend budgets, and lower or extend your own. - [Machines](https://tonbo.dev/docs/reference/management/machines.md): Create, list, read, change, sleep and delete Machines; their wakes and the shapes; and the planned calls that run inside one. - [Volumes](https://tonbo.dev/docs/reference/management/volumes.md): Create, list, read and delete Volumes, and read one Volume’s metrics. - [Token exchange](https://tonbo.dev/docs/reference/token-exchange.md): POST tonbo.dev/api/iam/token: exchange a key for an access token, or mint a narrower one for a web page. Every field, answer, refusal and rate limit. - [Streams HTTP overview](https://tonbo.dev/docs/reference/streams.md): Every request a stream’s URL serves: its address, credentials, offsets, shared headers, what goes through the Management API, and the error codes. - [Append and close](https://tonbo.dev/docs/reference/streams/append.md): POST to a stream: every header, producer answer and status of an append and a close. - [Read, tail and HEAD](https://tonbo.dev/docs/reference/streams/read.md): GET and HEAD on a stream: every parameter, header and status of a read, a long-poll, an SSE tail, HEAD and the cacheable reads. - [Snapshots and bootstrap](https://tonbo.dev/docs/reference/streams/snapshots.md): Publish, upload in parts and read a snapshot, advance retention and bootstrap: every header and status. - [Node.js SDK overview](https://tonbo.dev/docs/reference/nodejs.md): Every export of @tonbo/sdk and @tonbo/sqlite-ursula: options, return values, status fields and errors. - [@tonbo/sdk](https://tonbo.dev/docs/reference/nodejs/resolve-database.md): openDatabase() and resolveDatabase() by name with your key, the Tonbo client and TonboError. - [open()](https://tonbo.dev/docs/reference/nodejs/open.md): Open a stream by URL with a token: every option, the result and the errors. - [UrsulaDatabase](https://tonbo.dev/docs/reference/nodejs/database.md): The connection open() returns: synced(), status(), reset listeners and close(). - [Status](https://tonbo.dev/docs/reference/nodejs/status.md): Every field db.status() reports, and the salvage entries. - [Errors](https://tonbo.dev/docs/reference/nodejs/errors.md): The error classes, each kind, when it happens and what to do. - [Tokens](https://tonbo.dev/docs/reference/nodejs/tokens.md): The token option, token providers, the token file and the one token a process carries. - [gate() and import](https://tonbo.dev/docs/reference/nodejs/gate-and-import.md): Hold an outcome until synced(), and import a plain SQLite file. - [Pi Durable storage](https://tonbo.dev/docs/reference/nodejs/pi.md): openUrsulaPiStorage(): Pi Durable's SqliteStorage on a database. - [Environment variables](https://tonbo.dev/docs/reference/nodejs/environment.md): What the package and its extension read from the environment. - [SQL functions](https://tonbo.dev/docs/reference/nodejs/sql-functions.md): The extension's SQL functions, for hosts other than Node.js. - [Python SDK overview](https://tonbo.dev/docs/reference/python.md): Every export of sqlite-ursula 0.11.6: its install, platforms and versions, then a page per part. - [open() and aopen()](https://tonbo.dev/docs/reference/python/open.md): Open a database by its URL with a token: every keyword, the result and the errors. - [UrsulaConnection](https://tonbo.dev/docs/reference/python/connection.md): The connection open() returns: synced(), asynced(), status(), reset callbacks and its sqlite3 members. - [Errors](https://tonbo.dev/docs/reference/python/errors.md): The error classes, each kind with its action, when it happens and what to do. - [gate(), import and tokens](https://tonbo.dev/docs/reference/python/gate-and-import.md): Hold a block's outcome until synced(), import a plain SQLite file, and set the token. - [LangGraph](https://tonbo.dev/docs/reference/python/langgraph.md): UrsulaSaver, UrsulaStore and their asyncio forms: LangGraph's SQLite classes on a database. - [CLI](https://tonbo.dev/docs/reference/cli.md): Every command of the tonbo CLI: its flags and defaults, the operation it calls, its --json output and an example. - [yield CLI](https://yield.tonbo.io/docs/reference): Every command and flag of the yield CLI, on Yield’s own docs. - [Self-host Ursula](https://ursula.tonbo.io/docs/install): Install and run the open-source server yourself. - [Ursula protocol](https://ursula.tonbo.io/docs/specs/durable-stream): The durable streams protocol Tonbo serves. ## Platform - [Regions](https://tonbo.dev/docs/platform/regions.md): Where Tonbo runs, what each region offers, the default, how to choose one and each region’s origins. - [API keys and tokens](https://tonbo.dev/docs/platform/api-keys.md): Where open() finds the key, sending it directly, the token exchange, tokens for a web page, what a key can reach and the token refresher. - [Budgets](https://tonbo.dev/docs/platform/budgets.md): Monthly spend limits for the account and for each agent’s Machines: the stages, what counts, how writes slow down, and how far past the limit spending can go. - [Security internals](https://tonbo.dev/docs/platform/internals/security.md): How a Machine’s disks and Volumes are encrypted, who can use each key, what keeps Machines apart, and what a deletion destroys. - [Accounts](https://tonbo.dev/docs/platform/accounts.md): Personal accounts and organizations, choosing the account you act in, and which to use. - [Members and roles](https://tonbo.dev/docs/platform/members.md): The people and Agents of an account, their roles, inviting a person, leaving, and how keys act as a member. - [Agents](https://tonbo.dev/docs/platform/agents.md): Adding an Agent, how it is authorized, what its token reaches and for how long, who manages its keys, and its budget. - [Usage and billing](https://tonbo.dev/pricing.md#faq): What is metered, the monthly allowance, prepaid credit and a zero balance. - [Rotate a key](https://tonbo.dev/docs/platform/rotate-key.md): Replace an API key without stopping its program: create the next key, deploy it, revoke the old one. - [Give an Agent a budget](https://tonbo.dev/docs/platform/agent-budget.md): Create an Agent under a monthly limit for the Machines it creates, give it a key, watch what it uses and change the limit. - [When a member leaves](https://tonbo.dev/docs/platform/member-leaves.md): Move a person’s programs to Agents, keep an owner, remove them in the console, and rotate the keys they could read. - [Delete your account](https://tonbo.dev/docs/platform/delete-account.md): Hand on the organizations you own alone, export what you keep, and delete your account in the console. - [Concepts](https://tonbo.dev/docs/platform/concepts.md): An account, its members and keys, a region and the cell that runs it: how they fit together. - [Data protection](https://tonbo.dev/docs/platform/data-protection.md): How your data is encrypted on the network and on disk, who holds the keys, and what that does not protect against. - [What we observe](https://tonbo.dev/docs/platform/observability.md): What Tonbo measures to draw your metrics, where it measures it, how long it keeps it, who can see it, and how it stays apart from billing.