Documentation
Welcome
Documentation for TOPOS and Dialogues
Updated June 30, 2026
Welcome to TOPOS docs
TOPOS is your personal AI node — a private Topos Database and Topos Engine where your data, context, permissions, and compute stay under your control.
This documentation covers everyday questions, self-hosting, and — for developers — integrating apps with Dialogues.
New to TOPOS?
Start with Frequently asked questions for a concise overview of what TOPOS is, why it matters, and whether to run a node on your own device or use our hosted service.
On the home page, Step 1 is creating a Dialogues account; the rest of the guide walks through installing TOPOS, adding data sources, and sharing on your terms.
Developer guides
If you are building an app that reads or writes user data through Dialogues:
- Register your app —
app_id, scopes, sources, and redirect URIs - Add Dialogues auth — Grant Access (OAuth PKCE) in your client
- Create sources with the Dialogues API — declare and ingest data
Self-hosting
TOPOS is open source. See Self-host TOPOS on GitHub for install and operations, or Pricing for hosted plans if you prefer not to run your own node.
More
- Pricing — hosted and self-hosted plans
- Blog — product notes and implementation updates from the team
- Help: when "no results" isn't the whole story — how to read an empty answer and get the right one on the next try