Skip to content

Have an AI agent? Let it explore Teleon for you. Any assistant works, personal or coding.

Connect your agent
What your agent reads

The request it copies

Explore teleon.dev for me and report back. Read https://teleon.dev/llms.txt, https://teleon.dev/.well-known/agent-card.json and https://teleon.dev/.well-known/mcp.json. Summarize the shared backend primitives at https://teleon.dev/docs and the THP v1.0 connection steps at https://teleon.dev/connect. Stay read-only.

Discovery files on teleon.dev

Read-only discovery is open. Keep TELEON_KEY in your own environment.

Teleon
Sign inApply for an instance
Find and store

Read-only snapshots, close to every reader.

teleon.dev/docs/cdn serves content-addressed snapshots and archives from the edge. Search indexes and datasets publish as snapshot files that clients query by range, straight from the nearest edge.

teleon.dev/docs/cdnEdge CDNTELEON-SVC-02https
How a snapshot reaches a reader
teleon.dev/docs/search builds an indexon a schedule
Snapshot stored by content IDswh:1:cnt:3c7a…d2
Served from edge caches
Edge, Frankfurt
Edge, Virginia
Edge, Singapore

The pointer moves to each new snapshot; old snapshots stay readable by ID.

What it does

Snapshots by content ID

Every snapshot is named by its hash, so caches stay correct.

Query by range

SQLite and DuckDB files answer queries with HTTP range reads.

Close to the reader

Edge caches answer most reads near the agent.

The contract

Snapshots are immutable; a new snapshot gets a new ID and a pointer moves to it.

ContentsIndex and dataset snapshots, archives
FormatSQLite and DuckDB files
RefreshNew snapshot on a schedule, pointer updated
AccessRING-3 read only
Identifiers
  • swh:1:cnt:sha1_git + sha256
Request and responseCopy
GET /snapshots/search/latest.json # Response { "snapshot": "swh:1:cnt:3c7a...d2", "format": "sqlite", "built_at": "2026-10-25T22:00:00Z", "url": "https://teleon.dev/files/cdn/s/3c7a...d2.sqlite" }

Endpoints

MethodPathAccessWhat it doesStatus
GET/snapshots/{name}/latest.jsonRING-3Find the current snapshot for a name
GET/s/{swhid}.sqliteRING-3Read a snapshot by range

Listed paths appear in the service’s published files today. In the one-host plan every path here is served under api.teleon.dev/v1/cdn.

For agents

Give your agent the read-only guide first. It reports back before any write.

Agent prompt
Read https://teleon.dev/docs/cdn.md and find the current search snapshot. Read only.
Copy

Words on this page

Full glossary
Edge
Servers close to the reader that answer requests quickly and pass the rest to the origin.
Range request
An HTTP request for a span of bytes, answered with status 206.
SWHID
Software Heritage identifier: a permanent ID made from a file's hash, such as swh:1:cnt: followed by 40 hex digits.