supernote
Supernote is a lightweight, self-hosted private cloud server for Ratta Supernote notebooks. It syncs .note files locally using SQLite, runs on ~200MB idle memory with 300-400MB peak usage, and optionally integrates AI synthesis via Google Gemini API.
Ficha actualizada 23 sept 2026, 2:56 · upstream 23 sept 2026, 2:51 · release 0.23.0
Qué es supernote
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Supernote Private Cloud & Knowledge Hub is a self-hosted, SQLite-based implementation of the Supernote Private Cloud protocol. It provides a simple, resource-efficient sync server that runs locally on your NAS or home lab server without requiring external cloud infrastructure. The project implements 100% of the community-supernote-openapi.yaml specification and can optionally be enhanced with an AI-driven synthesis engine using Google Gemini to transcribe handwriting from notebooks into structured knowledge.
The system supports full notebook parsing, PDF export, task management via iCalendar (.ics) feeds for calendar integration (Home Assistant, Apple Calendar, Google Calendar, Outlook), semantic search across all notebooks, and secure MCP server connections to AI agents. It is designed as a lightweight alternative to the official Supernote Private Cloud service, offering complete data ownership with no external data leakage.
Key features include: offline operation via SQLite storage, asynchronous processing for large notebooks (up to 30GB+), configurable prompt templates for OCR and summarization, iCalendar export for task scheduling, and an admin CLI tool for user management. The architecture is modular, allowing developers to extend functionality through Python async clients or Docker containers.
- Local notebook syncing without cloud dependency
- Offline-first knowledge management on NAS devices
- AI-powered note synthesis from handwritten journals
- Task scheduling via iCalendar feeds for calendar integration
- Semantic search across multiple notebooks with concept-based queries
- Secure, self-hosted private cloud for sensitive personal data
- Runs entirely on local hardware with SQLite storage (~200MB idle)
- 100% compliant with the official Supernote OpenAPI specification
- Supports async processing of notebooks up to 30GB+ in size
- iCalendar (.ics) export for integration with Home Assistant, Apple Calendar, and Outlook
- MCP server enables secure AI agent connections (Claude, Gemini, ChatGPT)
- Configurable prompt templates allow custom OCR and summarization behavior
- Requires a local Python environment or Docker container to run the sync server
- No built-in user authentication beyond basic admin CLI commands
- AI synthesis requires an active Google Gemini API key for transcription and summarization
- Semantic search is concept-based rather than keyword-based, which may miss exact matches
- Notebook parsing is a fork of supernote-tool with slightly different dependencies
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
To deploy Supernote, install the server component via pip or Docker. For local deployment: use `supernote serve` from Python or run `docker run -d -p 8080:8080 -v $(pwd)/storage:/data supernote`. For AI features, set an environment variable for the Gemini API key and ensure a custom prompts directory exists with OCR/summary templates. The server listens on port 8080 by default; you can configure it via config.yaml or environment variables. Always back up your SQLite database before deploying to production.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.