Installation

Scaffold a new project, or add Redtuma to an existing TypeScript app.

Scaffold a project

The fastest way to start. Pick the default template, or the Cloudflare edge template.

Terminal

# default (Node) project
npm create redtuma@latest my-agent

# Cloudflare Workers + Durable Object memory
npm create redtuma@latest my-agent -- --template cloudflare

Add to an existing project

Install the core package and at least one AI SDK provider. Providers are optional peer deps, so install only the ones you use.

Terminal

npm install @redtuma/core zod
npm install @ai-sdk/anthropic   # and/or @ai-sdk/openai

Optional packages, added as you need them:

@redtuma/memory — persistent memory and semantic recall
@redtuma/rag — chunking, embeddings and retrieval
@redtuma/deployer — expose agents and workflows over HTTP
@redtuma/store-do — Cloudflare Durable Object memory
@redtuma/store-pg / @redtuma/store-libsql — database stores
@redtuma/mcp, @redtuma/observability

Requirements

Node.js 20+. Redtuma is ESM-only and ships its own type definitions.

API keys

Providers read keys from the environment — e.g. ANTHROPIC_API_KEY or OPENAI_API_KEY. On Cloudflare, set them as secrets and pass them to the provider explicitly (see Cloudflare).

← Introduction Quickstart →