Login

Tortoise Documentation

A memory graph for AI agents. Agents write what they learn; Tortoise remembers why — and confidence propagates through every relationship.

What is Tortoise? Quickstart (5 minutes) Core concepts API reference Next steps

What is Tortoise?

Tortoise is a hosted knowledge-graph memory system for AI agents. Unlike a vector store (which remembers what was said) or a key-value cache (which remembers that it happened), Tortoise remembers why — each belief carries the evidence and reasoning that produced it, and new information propagates confidence through the graph.

Agents use Tortoise to:

Quickstart (5 minutes)

1. Create an account

Sign up at tortoise.premiselabs.co/signup. You'll get an API key on the welcome page — copy it. It's shown once.

2. Write your first Point

curl -X POST https://api.premiselabs.co/v1/points \
  -H "Authorization: Bearer tt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "the production port is 16379", "kind": "statement"}'

Response includes the Point's id.

3. Search

curl "https://api.premiselabs.co/v1/search?q=port" \
  -H "Authorization: Bearer tt_YOUR_KEY"

Returns ranked results (FTS + vector + structural, RRF-fused).

4. Manage in the dashboard

Open app.premiselabs.co, paste your key, and you can create/revoke API keys and view sessions.

Core concepts

Points

The atomic unit of knowledge. Kinds: statement, decision, evidence, observation, hypothesis.

Operators & edges

Points connect via labeled edges. IMPL = one belief implies another; NAND = a contradiction between two beliefs (recorded, not erased).

EP (Evidence-Propagation) confidence

Each Point carries a belief score. New evidence propagates confidence through the graph — strong supporting evidence raises a Point's confidence; contradictions lower it. This is what makes Tortoise a computational memory, not a store.

Sessions

Agent conversations can be captured as Sessions and linked to the Points they produced, giving every insight provenance back to the conversation that created it.

API reference

Base URL: https://api.premiselabs.co. All endpoints require Authorization: Bearer tt_<key>.

EndpointMethodPurpose
/v1/teamGETTeam info: tier, limits, point count
/v1/pointsPOSTCreate a Point
/v1/pointsGETList Points
/v1/points/{id}GETGet one Point
/v1/searchGETHybrid search (query param q)
/v1/team/keysGETList API keys
/v1/team/keysPOSTCreate API key (plaintext shown once)
/v1/team/keys/{id}DELETERevoke API key
/v1/sessionsGETList captured sessions
/v1/sessionsPOSTRecord a session
Note: The context field is deprecated (removed from Point metadata). Use kind to classify content.

Next steps