Installation

Prerequisites

• Node.js 18+
• A Cloudflare account (free)
• An API key for your chosen LLM provider (Groq, Google AI Studio, or Cerebras)

Option A — CLI (recommended)

The fastest way to start:

npx create-moon-wave-app my-agent

This runs an interactive wizard that generates a fully configured project.

Option B — Manual setup

Install the packages you need:

npm install @moon-wave/core @moon-wave/providers

Add optional packages based on your use case:

# Memory
npm install @moon-wave/memory

# Multi-agent
npm install @moon-wave/multi-agent

# Telegram / Web Chat channels
npm install @moon-wave/channels

Cloudflare setup

Install Wrangler (Cloudflare’s CLI):

npm install -D wrangler
npx wrangler login

Create a wrangler.toml:

name = "my-agent"
main = "src/index.ts"
compatibility_date = "2024-01-01"
compatibility_flags = ["nodejs_compat"]