Distillery

io.github.norrietaylorPublished by GitHub account norrietaylorv0.7.0Updated Oct 24, 2026

Knowledge base for Claude Code with semantic search, feed intelligence, and teams

VerifiedSTDIODesktop onlyProductivity & WorkflowKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

A local team knowledge base that lets an assistant capture, classify, and semantically search notes, meetings, and bookmarks.

What you can do
Distillery stores distilled team knowledge as vector embeddings in a local DuckDB database and retrieves it through natural language. It exposes Claude Code slash commands for capturing session knowledge, semantic recall with provenance, multi-entry synthesis, meeting minutes, bookmarks with summaries, feed monitoring and digests, GitHub issue and PR sync, and a team knowledge dashboard. It can also run as a hosted HTTP service with GitHub OAuth for team access.
When to use it
Worth adding when a team wants a private, searchable memory of decisions, meetings, and links that an assistant can query and synthesize. Useful for recurring recall of past context, feed monitoring, and GitHub activity summaries. Not needed for one-off questions or public web lookups.
Requirements
Runs locally as a Python package (Python 3.11+ and uv) over stdio; the default fastembed provider works offline with no API key. Optional hosted embedding providers require DISTILLERY_EMBEDDING_PROVIDER plus JINA_API_KEY or OPENAI_API_KEY. A hosted demo endpoint is available for evaluation. Desktop only.
Before you install
The hosted demo endpoint is for evaluation only and should not receive sensitive or confidential data. Optional embedding providers send content to Jina or OpenAI and require the JINA_API_KEY or OPENAI_API_KEY secret. The server writes knowledge entries, bookmarks, minutes, and synced GitHub data to its local store, and feed or GitHub sync pulls data from third-party sources.

Installation

In SourceWeft

  1. Open Distillery in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Distillery]

Distillery

Team Knowledge, Distilled
Capture, classify, connect, and surface team knowledge through conversational commands.

Documentation · Skills · Quick Start · Roadmap · Slides

[PyPI version] [PyPI downloads] [License] [Python version]

What is Distillery?

Distillery is a team knowledge base accessed through Claude Code skills. It refines raw information from working sessions, meetings, bookmarks, and conversations into concentrated, searchable knowledge — stored as vector embeddings in DuckDB and retrieved through natural language. Runs locally over stdio or as a hosted HTTP service with GitHub OAuth for team access.

Distillery captures the highest-value transformation — from noise to signal — and makes it a tool the whole team can use.

Full documentation: norrietaylor.github.io/distillery

[Distillery demo — /distill captures a decision, /pour synthesizes it]

Skills

Distillery provides 15 Claude Code slash commands:

SkillPurposeExample
/distillCapture session knowledge with dedup detection/distill "We decided to use DuckDB for local storage"
/recallSemantic search with provenance/recall distributed caching strategies
/pourMulti-entry synthesis with citations/pour how does our auth system work?
/compassContrast internal knowledge vs. ambient intelligence for a directional assessment/compass our caching strategy
/bookmarkStore URLs with auto-generated summaries/bookmark https://example.com/article #caching
/minutesMeeting notes with append updates/minutes --update standup-2026-03-22
/classifyClassify entries and triage review queue/classify --inbox
/watchManage monitored feed sources/watch add github:duckdb/duckdb
/radarAmbient feed digest with source suggestions/radar --days 7
/tuneAdjust feed relevance thresholds/tune relevance 0.4
/digestTeam activity summary from internal entries/digest --days 7 --project myapp
/gh-syncSync GitHub issues/PRs into the knowledge base/gh-sync owner/repo --issues
/investigateDeep context builder with relationship traversal/investigate distributed caching
/briefingTeam knowledge dashboard with metrics/briefing --days 7
/setupOnboarding wizard for MCP connectivity and config/setup

Quick Start

Step 1: Install the Plugin

bash
claude plugin marketplace add norrietaylor/distilleryclaude plugin install distillery

This installs all 15 skills. The plugin does not configure an MCP server automatically — run /setup (below) to add one. The recommended setup runs locally via uvx --from 'distillery-mcp[fastembed]>=0.6.0' distillery-mcp — a private, self-contained knowledge base on your machine, with on-device fastembed embeddings (no API key required). Requires Python 3.11+ and uv (install: curl -LsSf https://astral.sh/uv/install.sh | sh).

Step 2 (Optional): Use Jina or OpenAI Instead

The default fastembed provider runs offline with no API key. If you'd rather use a hosted embedding service, set DISTILLERY_EMBEDDING_PROVIDER and provide the matching API key:

bash
# Jina (free tier at jina.ai)export DISTILLERY_EMBEDDING_PROVIDER=jinaexport JINA_API_KEY=jina_...
# Or OpenAIexport DISTILLERY_EMBEDDING_PROVIDER=openaiexport OPENAI_API_KEY=sk-...

uvx inherits these from your shell environment. See distillery.yaml.example for the full provider configuration block (including Option C for fastembed model selection).

Restart Claude Code and run the onboarding wizard:

text
/setup

Try the Hosted Demo (Opt-In)

Want to evaluate without installing anything locally? Configure the hosted demo at distillery-mcp.fly.dev instead of a local server:

bash
claude mcp add distillery --scope user --transport http --url https://distillery-mcp.fly.dev/mcp

Demo Server: distillery-mcp.fly.dev is for evaluation only. Do not store sensitive or confidential data.

See the Local Setup Guide for full configuration options, or deploy your own instance for team use.

Development

bash
uv pip install -e ".[dev]"# orpip install -e ".[dev]"pytest                              # run testsmypy --strict src/distillery/       # type checkruff check src/ tests/              # lint

See Contributing for the full guide.

License

Apache 2.0 — see LICENSE for details.

Source: README.md at commit d6697cc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.7.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.