Synap

Guides

Everything you need to understand and build with Synap — from the three core primitives to self-hosting your own pod.
Start here

The Three Primitives

Entities, views, and channels are the building blocks of everything in Synap. Understand these and you understand the whole system.

Entities

Your data, structured by AI. 14 built-in types, typed properties, automatic classification, and a knowledge graph that grows itself.

Read guide

Views

Any lens over your data. 12 view types — table, kanban, calendar, graph, whiteboard — same data, different perspective.

Read guide

Channels

Where data meets conversation. AI threads, entity comments, document review, direct messaging, and external imports.

Read guide

Platform

The systems that make Synap sovereign, searchable, and composable.

Event Chain

Every write — yours, AI, connectors — recorded in an immutable chain. Proposals, audit trail, time-travel, rollback.

Read guide

Search

Three search layers: Typesense (full-text, instant), pgvector (semantic, meaning-based), PostgreSQL (structured queries).

Read guide

AI Features

Two-layer agents, persistent threads, reusable commands, any AI model. How Synap's intelligence layer works.

Read guide

Bento Dashboards

Compose any interface from 72+ cells. View cells, entity cells, widget cells — all on a 12-column grid.

Read guide

Connectors

Sync Google Calendar, Contacts, GitHub into your pod. OAuth via Nango. Connector data becomes regular entities.

Read guide

Capture

Zero friction, any source. Desktop, Telegram bot, API, browser. AI classifies it automatically.

Read guide

Profiles

Custom entity types and schema. 14 built-in profiles, inheritance, property types. Create your own for any workflow.

Read guide

Export

Your data, always portable. SQL dump, JSON, Markdown, S3 mirror. Direct database access. No lock-in.

Read guide

Intelligence

Threads, commands, agents, and connections — the AI layer.

Threads

Persistent AI conversations. Return to them, branch, reference. Context stays intact.

Read guide

Commands

Reusable AI shortcuts. Prompt templates, arguments, run from app or palette.

Read guide

Agents

Specialized AI assistants with custom instructions, models, and tools.

Read guide

Connections

Link intelligence providers, APIs, or tools to extend your workspace.

Read guide

Developer

API reference, self-hosting, automation recipes, and integration guides.

Developer API

tRPC, Hub Protocol REST, and @synap-core/sdk. 18 scopes, Bearer auth, full CRUD over your pod.

Read guide

Pod API Quickstart

Base URL, auth, and copy-paste examples: curl, JavaScript, Python.

Read guide

Self-Hosting

Run Synap on your own server. Docker Compose, full stack, same codebase as managed pods.

Read guide

Recipes

Outcome-based flows: form → task, CSV import, outline → timeline.

Read guide

Automations

Webhooks, API keys, event logs, and bridging to n8n/Make.

Read guide

Connect with n8n

Connect Synap webhooks to n8n for 500+ app integrations.

Read guide

LLM Prompt Pack

System prompt for n8n/ActivePieces AI nodes. Strict endpoints, no hallucination.

Read guide