elizaOS REST API - Elysia

A simple REST API server for chatting with an elizaOS agent using Elysia (Bun's fast web framework).

No API keys or external services required! Uses:

Quick Start

bash

# From the monorepo root, install dependencies
cd /path/to/eliza
bun install

# Start the server
bun run examples/rest-api/elysia/server.ts

Note: This example must be run from the monorepo root to resolve workspace dependencies.

The server will start at http://localhost:3000

Returns information about the agent.

bash

curl http://localhost:3000/

Health check endpoint.

bash

curl http://localhost:3000/health

Send a message to the agent.

bash

curl -X POST http://localhost:3000/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, how are you?"}'

Response:

json

{
  "response": "How do you do. Please state your problem.",
  "character": "Eliza",
  "userId": "generated-uuid"
}

Set the PORT environment variable to change the default port:

bash

PORT=8080 bun run start

Elysia is a fast, type-safe web framework designed for Bun. It provides: