Install GNO

Reference

REST API

HTTP endpoints for search, query, ask, and graph — call GNO from any language.

GNO exposes 35+ HTTP endpoints through gno serve. Localhost-only by default with CSRF protection via origin validation. Use it to build internal tooling, automations, or custom product surfaces on top of your local index.

Launch the server

gno serve # default port 3000
gno serve --port 8080

Search endpoints

curl localhost:3000/api/search -d '{"q":"topic"}'
curl localhost:3000/api/vsearch -d '{"q":"concept"}'
curl localhost:3000/api/query -d '{"q":"topic"}'
curl localhost:3000/api/ask -d '{"q":"question"}'

Every search endpoint accepts the same flags as the CLI:

curl localhost:3000/api/query \
  -H 'content-type: application/json' \
  -d '{
    "q": "authentication",
    "collection": "notes",
    "limit": 20,
    "tags_any": ["security"]
  }'

Documents

GET /api/documents/:id
GET /api/documents?collection=notes
POST /api/documents # create
PUT /api/documents/:id # update
DELETE /api/documents/:id

Collections + indexing

GET /api/collections
POST /api/collections
POST /api/index
POST /api/embed
GET /api/status

Graph + links

GET /api/graph
GET /api/graph?collection=notes
GET /api/links/:id
GET /api/backlinks/:id
GET /api/similar/:id

Security model