Skip to main content
Agent Server adds a versioned graph registry, assistants, threads, runs, REST/SSE, a queue, and Studio. Local development uses an in-memory repository and embedded worker, so PostgreSQL and Redis are not required.
1

Install and scaffold

The project includes a graph module, lingxigraph.json, Dockerfile, and Compose configuration. Workers load only trusted import paths declared in the manifest.
2

Start the development server

  • Studio: http://localhost:8124/studio/
  • REST: http://localhost:8124/v1
  • Health: http://localhost:8124/health
3

Create a run through REST

Development mode enables explicit insecure authentication, so you can send X-Tenant-ID:
Copy the returned assistant id, then create a thread and run. See Threads and runs for the complete flow.
LINGXIGRAPH_INSECURE_DEV_AUTH=true and X-Tenant-ID are for local development only. Production must use OIDC/JWT and derive the tenant from a verified token claim.

​
Use Docker Compose

From the repository root:
Compose starts PostgreSQL 16, Redis 7.2, a migration job, and the API with an embedded worker. Named volumes hold data. Use docker compose down to stop; add -v only when you intentionally want to delete the data.

​
CLI reference