SurfSense/.serena/memories/project_overview.md

SurfSense - Project Overview

Purpose

Open-source alternative to NotebookLM — personal knowledge base with AI chat, 25+ external connectors (Google Drive, Notion, Jira, Slack...), real-time multiplayer, desktop app, podcast/video generation.

Tech Stack

• Backend: Python 3.12, FastAPI, Celery (Redis broker), PostgreSQL (pgvector), Alembic, LiteLLM, LangGraph, uv package manager
• Frontend: Next.js 16 (Turbopack), React 19, TypeScript, Tailwind v4, Jotai, @rocicorp/zero (real-time sync), pnpm
• Real-time: zero-cache (rocicorp/zero:0.26.2) → Postgres logical replication
• Services (Docker): PostgreSQL pgvector, Redis, SearXNG, pgAdmin, zero-cache
• Desktop: Electron (surfsense_desktop/)
• Browser Extension: surfsense_browser_extension/

Architecture

surfsense_backend/   - FastAPI + Celery workers
surfsense_web/       - Next.js frontend
surfsense_desktop/   - Electron desktop app
surfsense_browser_extension/ - Browser extension
docker/              - docker-compose.dev.yml & .env