# Sparkkeep – Single-binary Go/SQLite action engine for saved links and notes

> Source: <https://github.com/BurlacuAndrei/sparkkeep>
> Published: 2026-11-15 09:17:58+00:00

**Capture anything. Triage it with AI. Ship what matters.**

Sparkkeep is a self-hosted action engine for the ideas you keep collecting and never execute. Share a link, a note, a voice memo, or a screenshot — it scrapes it, filters the noise, synthesizes an actionable brief, and puts it on a board you actually work from.

One binary. One SQLite file. No Postgres, no Redis, no cloud account.

You save 200 interesting links. You open maybe four. The rest rot in a folder called "later".

Sparkkeep is not a bookmark manager. It is an action engine:

```
Capture ──► Noise Gate ──► AI Triage ──► Horizon Routing ──► Execution Board ──► Research ──► Digest ──► Shipped
```

1. **Capture** from Telegram, Discord, Slack, the browser extension, a webhook, or a plain note with no URL at all.
2. **Filter** engagement bait and spam before it reaches your inbox.
3. **Synthesize** a brief — TL;DR, why you'd care, and a checklist of next actions — using your own LLM.
4. **Route** work into Now, Next, or Later, and execute it from a widescreen board with inline checklists.
5. **Research** properly: deterministic playbooks that search, cite sources, and issue a Pursue / Watch / Skip verdict instead of hallucinating.
6. **Review** with a 7/14/30-day digest, then push finished notes to Obsidian, Notion, or Joplin.

```
docker run -d \
  --name sparkkeep \
  -p 8080:8080 \
  -v sparkkeep_data:/data \
  ghcr.io/burlacuandrei/sparkkeep:latest
```

Open **[http://localhost:8080](http://localhost:8080)**. The first-run wizard asks for a passphrase and an AI provider, and offers a one-click demo library so you can look around before committing.

## Other install options

**Docker Compose**

```
services:
  sparkkeep:
    image: ghcr.io/burlacuandrei/sparkkeep:latest
    container_name: sparkkeep
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
docker compose up -d
```

**Standalone binary** — ~24 MB, Linux / macOS / Windows, from [Releases](https://github.com/BurlacuAndrei/sparkkeep/releases):

```
tar -xzf sparkkeep-<VERSION>-linux-amd64.tar.gz
./sparkkeep-linux-amd64
```

**Build from source**

```
make build
```

[**Sparkkeep Cloud**](https://github.com/BurlacuAndrei/sparkkeep/issues/new?template=cloud_and_commercial.md) is an upcoming managed cloud service offering the Sparkkeep workflow with multi-user accounts, managed AI/search infrastructure, and zero server or API-key maintenance. The self-hosted edition remains complete and never held back. [Request early access or ask about a commercial license](https://github.com/BurlacuAndrei/sparkkeep/issues/new?template=cloud_and_commercial.md).

- **Zero-dependency storage** — pure-Go SQLite in WAL mode with FTS5 search. Runs on a Raspberry Pi, NAS, or 5 € VPS in under 30 MB RAM.
- **Omni-channel capture** — Telegram two-way bot, Discord embeds and buttons, Slack Block Kit, universal inbound webhook, and a Chrome/Firefox extension.
- **Triage from chat** — inline keyboards and ActionRows so you can route or shelve a card without opening the web app.
- **Board that drives work** — Focus Spotlight picks your highest-leverage card, Execution Pulse shows 7-day shipped velocity, swimlanes group by horizon or card type, and a docked inspector keeps the board live while you edit.
- **Card dossiers** — TL;DR, why it matters, checklist, and regenerable briefs. Notes without URLs become first-class Subject Cards.
- **Deterministic deep research** — bounded playbooks with a 5-Pillar Research Health Linter, cost estimator, and zero-cost dry runs. No unbounded agent loops.
- **Playbook Studio** — visual step sequencer for building your own research pipelines, routed automatically by card taxonomy.
- **Intelligence Digest** — period wins, momentum pulse, and an executive retrospective written by your own model.
- **Knowledge sinks** — idempotent one-way export to Obsidian, Notion, and Joplin, plus an authenticated RSS outbox and client intents for Logseq, Things 3, Todoist, and GitHub.
- **Privacy-first BYOK** — Ollama, LM Studio, vLLM, OpenAI, DeepSeek, or any OpenAI-compatible endpoint, with per-role model routing. Point it at local models and nothing leaves your hardware.
- **Operations ready** —`/livez` ,`/readyz` , zero-dependency`/metrics` , and a`backup` /`restore` CLI that snapshots safely while the daemon runs.
- **Six UI languages** — English, Romanian, Spanish, Portuguese (Brasil), French, German.

Go 1.26 standard-library HTTP, pure-Go SQLite (`modernc.org/sqlite`, no CGO), React 19 + TypeScript + Vite embedded into the binary with `//go:embed`. Optional companions: headless Chromium for scraping, `yt-dlp` for video, Whisper for audio, SearXNG for research search.

**Triage deck** — burn through the backlog with `1` / `2` / `3` / `Esc`.

**Research dossier** — cited sources, risk assessment, and a clear verdict.

**Playbook Studio** — visual pipeline builder with the 5-Pillar Research Health Linter.

**Intelligence Digest** — what actually shipped, and what to focus on next.

| [Configuration reference](https://github.com/BurlacuAndrei/sparkkeep/blob/main/docs/configuration.md) | Every environment variable, health probes, `/metrics` | 
| [Operations](https://github.com/BurlacuAndrei/sparkkeep/blob/main/docs/operations.md) | Backup, restore, upgrade, rollback, library export, browser extension | 
| [Localization](https://github.com/BurlacuAndrei/sparkkeep/blob/main/docs/localization.md) | Adding a language to the UI | 
| [System architecture](https://github.com/BurlacuAndrei/sparkkeep/blob/main/docs/design.md) | How the pipeline fits together | 
| [Decision records](https://github.com/BurlacuAndrei/sparkkeep/blob/main/docs/adr) | Why the research, taxonomy, and sink designs look like this | 

Sparkkeep is free and open source under [AGPL-3.0](https://github.com/BurlacuAndrei/sparkkeep/blob/main/LICENSE). If it earns a place in your workflow:

- ⭐ [**Star the repository on GitHub**](https://github.com/BurlacuAndrei/sparkkeep) — the fastest zero-cost way to help others discover Sparkkeep
- ☕ [**Buy me a coffee on Ko-fi**](https://ko-fi.com/andreiburlacu)
- 💖 [**Sponsor on GitHub**](https://github.com/sponsors/BurlacuAndrei)

**Supporter perks:**

- **README Supporter Wall** — your name, handle, or company badge listed in the repository
- **Priority Triage** — priority review on feature requests, bug reports, and new knowledge-sink integrations
- **Sparkkeep Cloud Early Access** — first-wave invite and founding credit when managed hosting opens

Contributions are welcome — see [CONTRIBUTING.md](https://github.com/BurlacuAndrei/sparkkeep/blob/main/CONTRIBUTING.md) and [SECURITY.md](https://github.com/BurlacuAndrei/sparkkeep/blob/main/SECURITY.md).

A commercial license is available for closed-source or SaaS distribution where AGPL obligations cannot be met; [open a commercial inquiry](https://github.com/BurlacuAndrei/sparkkeep/issues/new?template=cloud_and_commercial.md) for terms. Self-hosting and internal use need no license key, now or later.
