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.

Every Arete client SDK and how to install it, in one place. If your agent is building the app, it normally runs these installs as part of that work. This page is here for when you want to check or change something by hand.

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 a hosted browser stack, provide the publishable key required by its exact descriptor and pass it to AreteProvider as auth={{ publishableKey }}. Read-only viewing may require 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.51.2"

---

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