Connect

API Reference

TARX exposes an OpenAI-compatible REST API on localhost:11435. Use any OpenAI SDK.

Base URL

http://localhost:11435/v1

Authentication

Local inference requires no API key. Set api_key="none" in your client.

Endpoints

POST /v1/chat/completions

curl http://localhost:11435/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tarx-qwen2.5-7b-v2",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'

POST /v1/embeddings

curl http://localhost:11435/v1/embeddings \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nomic-embed-text-v1.5",
    "input": "Your text here"
  }'

GET /v1/models

curl http://localhost:11435/v1/models

Spaces API

# List spaces
GET /api/spaces

# Create space
POST /api/spaces  { "name": "my-project" }

# Search knowledge
POST /api/spaces/:name/search  { "query": "auth middleware" }

Health

GET /health    # Returns { "status": "ok" }

For the full MCP tool reference, see Skills.