Runtime Server

hlvm serve exposes the local runtime host for GUI clients and local tools.

hlvm serve

Default host:

http://127.0.0.1:11435

Core Endpoints

MethodPathPurpose
GET/healthRuntime health check
POST/api/chatChat, eval, and agent submissions
GET/api/chat/messagesCurrent conversation messages
GET/api/chat/streamServer-sent conversation events

Evaluate HQL

curl -X POST http://127.0.0.1:11435/api/chat \
  -H "Content-Type: application/json" \
  -d '{"mode":"eval","messages":[{"role":"user","content":"(+ 1 2)"}]}'

Chat

curl -X POST http://127.0.0.1:11435/api/chat \
  -H "Content-Type: application/json" \
  -d '{"mode":"chat","messages":[{"role":"user","content":"hello"}]}'

Local AI Boundary

The runtime host is not the local LLM engine. HLVM's managed local AI endpoint is 127.0.0.1:11439, and HLVM owns that path.

Next