Quickstart
Quickstart
Five minutes from nothing to a live subscription. Every path below drives the same local HTTP server; pick the client you will actually use.
The shape of every quickstart
any init ──▶ any run ──▶ POST /v1/spaces ──▶ POST …/objects ──▶ POST …/objects/query ──▶ POST …/objects/query/subscribe
(account) (server) (a space) (an object) (a snapshot) (snapshot + live deltas)
- Install the binary and create an account. The mnemonic prints once — back it up.
- Run the server:
any runlistens onhttp://127.0.0.1:7001. - Create a space — the unit of sharing and encryption.
- Create an object with a type bound and a name.
- Query the space's objects collection — an indexed read on your disk.
- Subscribe — the same query, plus
added/updated/removedframes over SSE for as long as the connection is open.
Everything you write is on your machine the moment the request returns; sync to other devices and members happens in the background (Local-first).
Before you start
any init # prints the mnemonic to stderr — save it
any run # foreground; leave it running in this terminal
any status # in another terminal: {"status":"ok", …}
Note. A binary with no network configured joins the production any-sync network. To experiment without touching it, point
ANY_NETWORK_NODECONF_PATHat a staging or local nodeconf first — see Networks.
Pick a client
| Page | You get |
|---|---|
| Install | Release tarballs, building from source, first-run account creation. |
| curl | The four calls with raw JSON, including reading an SSE stream with curl -N. |
| CLI | The same flow with any … subcommands and jq. |
| JavaScript | fetch + a streaming reader for the POST-based SSE. |
| Python | urllib / http.client, no third-party packages. |
| Android | Embedding the server as any.aar in an app process. |
| iOS | Embedding as any.xcframework. |
| anyrt | anybao.toml, anyrt serve, and a first trigger record. |
| Networks | Production vs staging vs local nodeconf, and the placeholder that joins nothing. |
InstallGet the binary and create an account.
curlSpace → object → query → subscribe with raw HTTP.
CLIThe same flow with the any command.
JavaScriptfetch, ReadableStream, and SSE frames.
PythonStandard library only.
AndroidEmbed the server with any.aar.
iOSEmbed the server with any.xcframework.
anyrtRun the agent runtime and schedule a program.
NetworksWhich any-sync network you are talking to.