↓ Skip to main content

Brainstack

·166 words

A personal, fully self-hosted “second brain” pipeline that transforms unstructured daily voice memos into an organized, queryable digital knowledge store.

Built with a microservice philosophy, Brainstack connects a private Telegram interface directly to local AI transcription and intelligent categorization models, running entirely within a private homelab environment.

Architectural Overview
#

  • Telegram Bot (brainstack-bot): Ingests spontaneous voice thoughts and text messages directly from a private Telegram chat, enabling frictionless note capture on mobile.
  • Local Speech-to-Text (faster-whisper): Transcribes audio notes locally on the host machine, guaranteeing privacy and zero external audio leakage.
  • Intelligent Synthesis (google-genai): Analyzes and structures raw reflections into standardized Markdown journal entries categorized into action items, content draft ideas, and analytical reflections.
  • FastAPI Web Interface (brainstack-web): A lightweight FastAPI web application serving pure HTML templates without frontend JavaScript bloat, allowing fast search, navigation, and editing of Markdown notes.
  • Data Sovereignty & Docker: Containerized with docker-compose for rapid homelab deployment. All personal reflections and environment configurations are kept strictly local.

Source Code
#

View on GitHub