Echo
Getting Started

Templates

Get started quickly with Echo using pre-built templates

The easiest way to get started with Echo is to use one of our pre-built templates.

React

The React template is a simple application that uses Vite and echo-react-sdk. Uniquely Echo does not require a server to make API calls because it handles Oauth directly in the browser.

Create a React app using Vite

Run the following commands to create a new React app using Vite.

npx echo-start@latest --template vite --app-id YOUR_ECHO_APP_ID
yarn dlx echo-start@latest --template vite --app-id YOUR_ECHO_APP_ID
pnpx echo-start@latest --template vite --app-id YOUR_ECHO_APP_ID
bunx echo-start@latest --template vite --app-id YOUR_ECHO_APP_ID

Next.js

The Next.js template is a full-stack application that uses the Next.js framework with the echo-next-sdk.

Create a Next.js app

Run the following commands to create a new Next.js app.

npx echo-start@latest --template next --app-id YOUR_ECHO_APP_ID
yarn dlx echo-start@latest --template next --app-id YOUR_ECHO_APP_ID
pnpx echo-start@latest --template next --app-id YOUR_ECHO_APP_ID
bunx echo-start@latest --template next --app-id YOUR_ECHO_APP_ID

Assistant UI

A full-featured chat UI powered by @assistant-ui/react integrated with Echo and the Vercel AI SDK v5.

Scaffold the Assistant UI template

Use degit to copy the example into a new directory.

npx degit Merit-Systems/echo/examples/assistant-ui my-assistant-ui
cd my-assistant-ui
npm install
yarn dlx degit Merit-Systems/echo/examples/assistant-ui my-assistant-ui
cd my-assistant-ui
yarn install
pnpx degit Merit-Systems/echo/examples/assistant-ui my-assistant-ui
cd my-assistant-ui
pnpm install
bunx degit Merit-Systems/echo/examples/assistant-ui my-assistant-ui
cd my-assistant-ui
bun install

Configure environment

Create a .env.local file and set your Echo App ID:

NEXT_PUBLIC_ECHO_APP_ID=YOUR_ECHO_APP_ID

Run the app

pnpm dev