Installation Reference

For AI agents: the documentation index is at llms.txt (full corpus: llms-full.txt). A markdown source for this page is /using-stacks/installation.md.

Complete installation reference for all Arete client SDKs.

New to Arete?

Start with the Quickstart to scaffold a working app, or Connect to a Stack to add Arete to an existing project.

Building your own stack?

If you’re creating a custom data feed, see Building Stacks → Environment Setup instead.

---

TypeScript (Core)

For Node.js, Vue, Svelte, or vanilla JS:

npm install @usearete/sdk

Framework-agnostic with AsyncIterable-based streaming. No peer dependencies.

---

TypeScript (React)

For React applications:

npm install @usearete/react @usearete/sdk zod

React is an application peer dependency. zustand is a normal dependency of @usearete/react and must not be installed separately. Generated stack files use the core SDK and Zod directly, so generated React consumers install all three packages shown above.

For hosted ORE browser apps, set VITE_ARETE_PUBLISHABLE_KEY and pass it to AreteProvider as auth={{ publishableKey }}. Read-only viewing requires authentication but does not require a wallet.

Which package?

• React/Next.js → @usearete/react
• Everything else → @usearete/sdk

---

Rust

Add to your Cargo.toml:

[dependencies]
a4-sdk = "0.20.1"

---

Next Steps

• Quickstart — Scaffold a working app in under 2 minutes
• React SDK — Build a complete React app
• TypeScript SDK — Use with Node.js, Vue, Svelte
• Rust SDK — Native Rust client

---

CLI

The Arete CLI (a4) handles project scaffolding, deployment, and SDK generation. Install the prebuilt binary:

curl -fsSL https://arete.run/install.sh | sh        # macOS / Linux
irm https://arete.run/install.ps1 | iex             # Windows PowerShell
npx @usearete/a4 install                            # if you prefer npm

The binary lands in ~/.local/bin/a4 (override with A4_INSTALL_DIR) and the installer prints A4_BIN=<absolute path>. Verify and update with:

a4 doctor --json
a4 self update

Full installer options: CLI Command Reference → Installation.

Building from source

Only if you need an unreleased build. It requires a Rust toolchain and is not the supported install path:

cargo install a4-cli

---

Troubleshooting

Issue	Solution
Cannot find module '@usearete/*'	Install the React, core SDK, and Zod packages shown above
React peer dependency warning	Install the React version required by your application