Self-host Kept
v1.0.1Local-first AI chat archive with search, graph, and MCP
- Stars
- 147
- Port
- 18241 (Local server for browser extension communication)
What is Kept?
Kept is a local-first desktop application that archives your AI conversations from major providers as plain Markdown files with YAML frontmatter in a local vault. A Chromium browser extension captures conversations via provider APIs and sends them to the Tauri 2 desktop app running on localhost. The app indexes content with SQLite FTS5 for fast full-text search, builds a knowledge graph in CozoDB for topic and entity discovery, and supports semantic recall via configured LLM providers or local Ollama models. It includes an MCP server so agents like Claude Code, Cursor, or Cline can read, write, and search the vault. The vault is Obsidian-compatible and can be exported to an existing Obsidian vault with edit preservation. No cloud sync or account is required; all data stays on the user's machine by default. The project is MIT licensed with no premium tier.
Should you self-host Kept?
Kept scores 46/100 on selfhost.directory (how scoring works) and ranks #41 of 69 in AI Chat. It has 147 GitHub stars.
It shipped 2 stable releases in the past year. The latest, v1.0.1, came out on 12 May 2026. New versions land roughly every 8 days.
Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.
Its closest alternative on selfhost.directory is ChatGPT Next Web (85/100, 88 905 stars). It scores higher overall, so compare the two before you pick. See Kept vs ChatGPT Next Web side by side.
Features
- AI conversation capture
- Auto-topic clustering
- Background auto-sync
- BYOK (Bring Your Own Keys)
- Claude Code integration
- Continue chats in-app
- Digests generation
- Full-text search (SQLite FTS5)
- Knowledge Graph
- Markdown vault
- MCP Server
- Obsidian export
- PDF and image reading
- Semantic recall
Kept README
FAQ
Can I contribute?
Yes, the repo is on GitHub under MIT. Open issues, send PRs, or star it. The desktop app is Rust + TypeScript; the extension is vanilla JS; the MCP server is TypeScript.
How does the Obsidian export relate to the markdown vault?
The markdown vault is Kept's default directory under your home folder. Obsidian export is a separate opt-in operation that copies the vault into a folder you point Kept at, preserving edits made on the Obsidian side. It's not full two-way sync.
Can I push a conversation back into ChatGPT or Claude?
Not currently. Vendors don't expose write APIs for chat history, and the project avoids fragile DOM-injection workarounds. If a clean way appears, it will be opt-in and clearly labeled.
What does MCP support mean in practice?
Kept's own agent can call any MCP server you connect, and Kept ships kept-vault-server on npm which exposes your vault over MCP so you can plug your archive into other MCP-aware clients to read, write, or search it.
Why sideload the extension instead of Chrome Web Store?
The Web Store review queue takes time, especially for an extension that touches multiple AI sites. The extension is feature-complete; loading it unpacked is straightforward. It will go through the store eventually.
Does any data leave my machine?
Nothing leaves your machine by default. Conversations are stored locally in SQLite and as Markdown. Only if you use Smart Recall or knowledge graph with cloud APIs (OpenAI, Anthropic, OpenRouter) do queries go to those providers. Using Ollama keeps everything on-device.
Is everything really in V1? No freemium?
Yes, the public release on GitHub is the full feature set with no premium tier or gated build. The project is MIT licensed.
More in Productivity
KimaiKimai is the #1 open-source time-tracking application. From freelancers to companies and organisations - everyone can manage timesheets, generate reports, create invoices and so much more... Web-based multi-user application, available as On-Premise or SaaS version: https://www.kimai.org
lastGLANCESelf-hosted, open-source chore tracking PWA with recency tracking, categories, WebDAV/Nextcloud sync, encryption, and native Android/iOS apps.
LetoReaderLetoReader is a free, open-source speed reading web app you can self-host via Docker or .NET. It uses RSVP with chunking and pacing to boost reading efficiency.
LexiconA free, open-source desktop editor for Windows, macOS, and Linux that checks grammar offline and rewrites text using local AI models — no account or cloud needed.
Many NotesSelf-hosted Markdown note-taking web app with multiple vaults, OIDC/OAuth auth, real-time collaboration, fast search, and PWA support.
matchaMatcha is a self-hosted, open-source CLI tool that creates daily markdown digests from RSS feeds with optional LLM summaries, weather, and Instapaper bookmarking.
meetilyAn open-source desktop app that records meetings, turns speech into text, and creates AI summaries — all running locally without sending data to the cloud.
midgardSelf-hosted clipboard manager syncing history across macOS, Linux, Windows, and phones with end-to-end encryption.
MindGenius AIA self-hosted AI agent that reads PDFs and creates editable mind maps on your own hardware — your documents and API keys stay local.
MindwtrGet tasks and ideas out of your head. A free GTD to-do app for desktop and mobile. Works offline, no account needed
minutesFree, open-source app that records and transcribes meetings locally into Markdown, then lets AI assistants like Claude Code search the history via MCP.
moodistSelf-hosted open-source ambient sound generator with 84 curated tracks for building custom listening environments at home.
0 comments