Open Source Β· Apache 2.0

Syne

"I remember, therefore I am"

Self-hosted personal AI assistant on Telegram with persistent long-term memory. Runs on your own server. Stores everything in your own PostgreSQL. Near-zero API cost with free OAuth providers or local Ollama.

Named after Mnemosyne, the Greek goddess of memory and mother of the Muses.

What Syne actually is

A Telegram bot you self-host. You chat with it. It remembers what you tell it to remember β€” across days, weeks, restarts.

🧠

Persistent long-term memory

Semantic search via pgvector + a small knowledge graph for entity-relation queries. Subject to decay (non-permanent memories fade with disuse) and conflict resolution (newer, higher-source-priority entries win).

πŸ›‘οΈ

User-confirmed memory filtering

A 3-layer filter (quick rules β†’ small local LLM evaluator β†’ similarity dedup) decides what's worth storing at write time. This reduces what enters memory; it is not a guard against the chat model hallucinating at read time.

πŸ”

Multi-tier permissions

Owner / family / public with Linux-style 3-digit octal per tool. Public users get nothing from memory by default β€” unless you explicitly open specific categories (Rule 765).

πŸ’¬

Runtime configuration in PostgreSQL

No SOUL.md or CONFIG.yaml. Identity, behavior, rules, and config all live in tables β€” change them through conversation.

πŸ’Έ

Near-zero API cost

Resilience floor: Ollama embeddings + small local evaluator are free and self-contained. Chat via Anthropic / Google / OpenAI / Vertex with paid API keys; OAuth gray-zone options are bonus for personal use.

πŸ€–

Multi-provider chat

Switch between Gemini, ChatGPT, Claude, Together AI, Vertex, Ollama mid-conversation β€” per-user and per-group overrides supported. No redeploy.

Advanced capabilities (opt-in)

Beyond the core assistant, Syne ships with optional extensions. These live in syne/abilities/ and can be enabled per install.

πŸ“Ž

Memory file attachments

Memories can carry binary files β€” images, PDFs, voice notes, Office docs β€” up to 50 MB. Description is embedded for semantic search; the file is preserved as a BYTEA blob for later retrieve or re-analysis.

πŸ“„

Document I/O

Read & create Word, Excel, PowerPoint, and PDF. Vision OCR for scanned pages. Created files use a bundled skeleton template β€” Syne picks the right layout automatically.

πŸŽ™οΈ

Voice in & out

Groq Whisper STT for inbound voice notes β€” transcribed and processed as text. Edge TTS for outbound voice replies (free, local). Voice notes can be saved as memory blobs for playback later.

πŸ§‘β€πŸ’»

Remote nodes & sub-agents

Extend Syne to multiple machines via WebSocket gateway β€” each node has its own CLI, one shared memory. Spawn background sub-agents for parallel tasks (isolated sessions, same memory).

🧬

Self-modification (off by default)

The LLM can write new abilities into syne/abilities/custom/ at runtime. Gated behind an explicit config flag β€” closes the prompt-injection-to-RCE vector. See SECURITY.md.

πŸ“Ž

Memory with File Attachments

Memories can carry binary files β€” images, PDFs, voice notes, Office docs β€” up to 50 MB. Description is embedded for semantic search; the file is preserved as a BYTEA blob for later retrieve or re-analysis (vision OCR for image pages, text extraction for documents).

πŸ“„

Document I/O β€” Word Β· Excel Β· PowerPoint Β· PDF

Auto-extract content from uploaded Office files and PDFs (text + vision OCR for scanned pages). Create new .docx, .xlsx, .pptx from structured input β€” Syne picks the right layout from the bundled skeleton template.

Get Started in 60 Seconds

One command to clone, one command to configure. That's it.

# Clone and install
git clone https://github.com/riyogarta/syne.git
cd syne
bash install.sh

install.sh handles all dependencies, creates a virtual environment, and runs syne init β€” which guides you through provider selection, Telegram bot setup, and starts PostgreSQL via Docker. No manual steps.

True Zero-Cost is Possible

Use free OAuth providers and local embedding for a completely free setup.

Minimum Setup
$0/month
Gemini OAuth + Ollama
  • Google Gemini 2.5 Pro (free OAuth)
  • Ollama embedding (local, free)
  • PostgreSQL + pgvector (Docker)
  • Telegram Bot API (free)
  • No credit card required
With Cloud Embedding
~$0.01/day
For low-resource systems
  • Same free OAuth chat
  • Together AI embedding (~$0.008/1M tokens)
  • Works on 1GB RAM systems
  • $5 free credit on signup
  • Optional image generation

Clean Architecture

Protected core, pluggable abilities, single-database truth.

Core (Protected)
Chat LLM
Memory pgvector
Graph KG
Compaction context
Channels TG + CLI
Gateway remote
Sub-agents
26 Core Tools: exec Β· memory (search/store/get/analyze/delete + file blobs) Β· web Β· config Β· files Β· voice Β· send Β· schedule Β· subagent Β· permissions
↕
Abilities (Pluggable)
image_gen
image_analysis
maps
pdf
office
screenshot
whatsapp
custom…
Self-created: Syne adds new abilities at runtime
↕
PostgreSQL + pgvector
18 tables β€” identity, memory (with binary blob attachments), knowledge graph, config, and more. Everything in one database.