Skip to content

Arete documentation

Open source and hosted Arete

For the complete documentation index optimized for AI agents, see llms.txt or llms-full.txt. A markdown version of this page is available by appending .md to the URL or sending Accept: text/markdown.

For AI agents: the documentation index is at llms.txt (full corpus: llms-full.txt). A markdown source for this page is /getting-started/open-source-and-hosted.md.

Arete’s client SDKs, CLI, protocol authoring tools, and stack tooling are open source. The hosted service at api.arete.run runs protocol deployments and cloud dev environments and adds registry discovery, review, receipts, and managed live data. This page explains those boundaries.

The SDKs, the CLI and the tooling you install into a project are in the AreteA4/arete repository:

ComponentLicence
The a4 CLI, its dev UI and the MCP server (a4 mcp)Apache-2.0
The stack DSL, the interpreter and the server cratesApache-2.0
The hash formats (arete-hash)Apache-2.0
The Rust SDK and arete-idlMIT
The TypeScript SDK (@usearete/sdk) and React bindingsMIT
@usearete/protocol: authoring, contracts, and handler toolingMIT
The Python SDK (arete-sdk)MIT

Each package’s LICENSE file is authoritative. Self-hosting the open-source stack server for your own app is welcome. That server provides live projections and typed reads. It does not supply the hosted protocol execution service or cloud dev environments. Installing the open-source protocol authoring package does not install a self-hosted protocol runtime.

a4 dev develops against an Arete cloud dev environment: a persistent fork of mainnet that Arete hosts for your account, where your protocol runs as it will in production, decoded by the same decoder. The CLI, the MCP server, the dev UI and your keys stay on your machine: transactions are signed locally, and a4 dev up serves the environment’s RPC on 127.0.0.1 for wallets and apps. Environments count against your plan (environments, active hours, storage, requests).

HostedWhat you get
Registry and discoveryPackages that agents and MCP clients find by intent, with exact versions to install
Review and receiptsReviewed releases, and a signed receipt for each attested execution that anyone can check offline and against the chain (protocol_receipt in a4 mcp)
Current program knowledgeProgram specs kept current as programs upgrade
HostingLive stacks with history, protocol deployments, and SLAs
Cloud dev environmentsPersistent mainnet forks for development, with checkpoints, branches, rebase, scenarios and transaction previews

Fees for hosted protocol execution support discovery, review, and operations. Arete sets the fee; a deployment can name a wallet for the creator’s share. The execution summary and attested receipts show the applicable fees and creator allocations.