fieldnote-assistant
Fieldnote is a local-first personal AI assistant that stores all data in SQLite and uses Algolia for semantic search with optional NeuralSearch hybrid retrieval.
Ficha actualizada 23 sept 2026, 3:29 · upstream 23 sept 2026, 2:59 · release sin release detectada
Qué es fieldnote-assistant
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Fieldnote is a personal assistant you actually own — it tracks todos, memories, conversations, and reminders while keeping everything stored locally on your disk. The interesting part is the split of responsibilities: SQLite holds the source of truth for all state, Algolia stores searchable projections of that data with optional hybrid semantic retrieval via NeuralSearch, and Agent Studio decides when to search versus call typed action tools. Because Algolia only maintains derived projections, reindexing is always safe to repeat without losing your data. The app runs as a single Node.js process using Express for the UI/API, Vite for the frontend bundle, and an in-process worker that fires every minute for reminders and digests.
- Track daily tasks with repeating rules (e.g., 'every day at 8am') that text you ahead of time
- Search your notes using natural language queries like 'what did I decide about the pricing work?' rather than exact keyword matches
- Send reminders via SMS or iMessage to yourself, including daily digests and evening check-ins
- Create shopping lists with product images sent directly to your phone as image cards
- Pull Jira/Confluence tickets for reading without opening those tools in a browser tab
- Maintain meeting notes through Granola polling with manual review before sending to the group chat
- SQLite stores all state, so reindexing is always safe and never loses data
- Algolia holds only derived projections; you can switch between exact keyword search and hybrid semantic retrieval without losing your notes
- The agent runs entirely in-process with typed action tools executed server-side, keeping the browser lightweight
- SMS/iMessage integration supports quiet hours, daily digests, group chat reminders, and image-based shopping cards
- Granola meeting-note polling allows manual review before sending to a shared group chat
- Requires Node.js 22+ — older versions will not run the app
- SQLite forces exactly one replica on any server, making it unsuitable for serverless platforms like Cloudflare Workers or Functions that scale to zero
- NeuralSearch is a paid add-on and requires Algolia credentials; without them semantic search falls back to SQLite LIKE scans which are slower than exact matches
- SMS integration depends on Twilio or Sendblue — no built-in fallback provider, so you must choose one upfront
- The app runs as a single process with no separate frontend host, database service, or cron job; if the Node process crashes, nothing is recovered
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.
Deploy as a single container using Docker. The `Dockerfile` and `railway.json` are included in the repo. SQLite requires exactly one replica instance with persistent storage — do not use serverless functions or ephemeral containers that restart on every request. For production, deploy to Railway (which supports this architecture), Cloudflare Tunnel for a stable public URL, or any Docker host with a persistent volume mounted at `/data/db`. The app serves the Vite UI on port 4173 and the API on port 4174.
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.