hono

elizaOS REST API - Hono

A simple REST API server for chatting with an elizaOS agent using Hono.

No API keys or external services required for local mode. Uses:

• plugin-sql with PGLite by default for local storage
• plugin-eliza-classic for pattern-matching responses (no LLM needed)

Quick Start

# Install dependencies
bun install

# Start the server
bun run start

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

API Endpoints

GET /

Returns information about the agent.

curl http://localhost:3000/

GET /health

Health check endpoint.

curl http://localhost:3000/health

POST /chat

Send a message to the agent.

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

Response:

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

Configuration

Set the PORT environment variable to change the default port:

PORT=8080 bun run start

Validate

bun run test
bun run typecheck

The test suite imports the Hono app without binding port 3000 and verifies CORS plus request validation.