memexc 0.1.0

A knowledge compiler that turns source documents into a living wiki

memex

Feed it papers. Get a wiki. It compounds.

A knowledge compiler that turns source documents into a living wiki. Sources are input. Claims are the intermediate representation. The wiki is the executable.

Install

pip install -e .

Or with optional extras:

pip install -e ".[dev]"          # development tools
pip install -e ".[embeddings]"   # sentence-transformers for semantic search

One-shot (no install): uvx memex

Quick Start

# Initialize a wiki
memex init ./my-wiki

# Ingest a source
memex ingest paper.pdf

# Query the wiki
memex query "What are the key findings?"

What is this?

Memex is a Python MCP server that compiles knowledge from source documents (PDFs, markdown files) into an Obsidian-compatible wiki backed by git. It implements Karpathy's LLM Wiki concept as a real software system.

Like a compiler:

• Sources (PDFs, markdown) → Claims (the IR) → Wiki (the executable)
• Every claim traces to a source
• Every article is derivable from its claims
• Incremental recompilation: only re-synthesize what changed

Architecture

Memex is organized in three layers:

1. Interface (server.py, cli.py) — MCP server and CLI. Thin dispatch layer; no business logic.
2. Ops (src/memex/ops/) — Orchestrates each operation (ingest, query, search, lint, …). Coordinates LLM, extractors, search, and VCS; never touches the filesystem directly.
3. Foundation — Four focused subsystems:
   • store/ — All filesystem I/O for the .memex/ directory (claims, manifest, citations)
   • llm/ — LiteLLM wrapper with Jinja2 templates and Pydantic structured output
   • extractors/ — Pluggable readers for PDF, Markdown, HTML, and URLs
   • search/ — BM25 claim search; vcs/ — Git integration

Upper layers never bypass the store layer. Every claim traces to a source; every article is derivable from its claims.

MCP Configuration

{
  "mcpServers": {
    "memex": {
      "command": "uvx",
      "args": ["memex", "--wiki-dir", "./my-wiki"]
    }
  }
}

License

MIT