Skip to content

Home

Jump to bottom
Alessandro Siniscalchi edited this page May 11, 2026 · 5 revisions

Welcome to Froid Wiki

Froid is an AI-powered personal journaling system that captures your thoughts via a Telegram bot, enriches them with structured analysis and semantic embeddings, and delivers daily and weekly reflections back to you.

Key Features

  • Telegram Integration: Capture journal entries naturally via a Telegram bot.
  • AI Extractions: Automatically extract structured data (emotions, behaviors, needs, patterns) from entries using LLMs.
  • Semantic Search: Find past entries based on meaning and context, not just keywords.
  • Daily Reviews: Receive AI-generated summaries and reflections on your day.
  • Weekly Reviews: Receive a higher-level synthesis of your patterns and progress over the past week (Monday to Sunday).
  • MCP Access: Query your journal, daily reviews, and weekly reviews programmatically via the Model Context Protocol Streamable HTTP server. Lets AI assistants read your data directly.
  • Privacy First: All data stored locally in SQLite with sqlite-vec for vector embeddings — no external vector store required.

Documentation Sections

  • Architecture — High-level system design and components.
  • Information Model — How entries are analysed, what is extracted, and how the daily and weekly reviews are built.
  • Data Model — Database schema and relationships.
  • Processing Pipeline — How entries flow through the system.
  • Workers — Background reconciliation tasks.

Clone this wiki locally