API

HTTP interface to the local Hermes runtime.

When CLAW NOVA runs locally, a small HTTP surface is exposed under /api. This is the bridge between the browser and external services that require server-side handling.

`POST /api/agent`

Server-Sent Events proxy to your configured model. Used by the in-app Agent surface to avoid CORS issues with local Ollama.

POST /api/agent
Content-Type: application/json

{
  "messages": [...],
  "model": "qwen2.5:7b",
  "stream": true,
  "tools": [...]
}

Streams data: {...} events terminated by data: [DONE], mirroring the OpenAI streaming contract.

`GET /api/search`

SearXNG proxy for the web_search tool. Set NEXT_PUBLIC_SEARXNG_URL to your preferred instance.

GET /api/search?q=hyperliquid+points

Returns:

{
  "results": [
    { "title": "...", "url": "...", "content": "..." }
  ]
}

Authentication

The local API has no authentication. It is intended to be bound to localhost only. If you expose it on a network, put it behind a reverse proxy with authentication.

PreviousSDK Next Security