Sign inSign up

applehell/contextpilot

By applehell

•Updated 2 months ago

Open source AI knowledge management platform — Web App + MCP Server (Python, MIT)

Image
Machine learning & AI
Data science
Content management system
0

1.0K

applehell/contextpilot repository overview

Docker Pulls Image Size Python License Architecture

⁠Context Pilot

Open source AI knowledge management platform
Web App + MCP Server — built with Python, MIT licensed

Website⁠ • GitHub⁠ • Features⁠ • API Reference⁠


⁠What is Context Pilot?

Context Pilot gives your AI assistant persistent, structured memory. Store knowledge once, use it with any AI model — Claude Code, GitHub Copilot, Ollama, LM Studio, or any MCP-compatible client.

  • No registration required — install and use immediately
  • No data leaves your machine — everything runs on localhost
  • MIT License — use, modify, distribute freely
  • Plugin-based connectors — extend with simple Python modules

⁠Quick Start

docker pull applehell/contextpilot:latest

docker run -d --name context-pilot \
  -p 8080:8080 -p 8400:8400 \
  -v context-pilot-data:/data \
  applehell/contextpilot:latest

Web UI: http://localhost:8080⁠ MCP Server: http://localhost:8400/mcp/ Health Check: http://localhost:8080/health⁠

⁠Docker Compose
services:
  context-pilot:
    image: applehell/contextpilot:latest
    container_name: context-pilot
    restart: unless-stopped
    ports:
      - "8080:8080"   # Web UI
      - "8400:8400"   # MCP streamable-http server
    volumes:
      - context-pilot-data:/data
      - /path/to/docs:/mnt/docs:ro    # optional: folder for indexing
    environment:
      - CONTEXTPILOT_DATA_DIR=/data

volumes:
  context-pilot-data:
docker compose up -d

⁠Connect to Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "context-pilot": {
      "type": "http",
      "url": "http://localhost:8400/mcp/"
    }
  }
}

Claude Code now has full access to your knowledge base.


⁠Features

FeatureDescription
MemoriesCreate, search (FTS5), tag, pin, TTL, bulk operations
17 ConnectorsGitHub, Gitea, Paperless-ngx, Email (IMAP), local folders
Plugin ArchitectureEvery connector is a Python module — write your own in minutes
MCP ServerBuilt-in Model Context Protocol server (streamable-http, port 8400)
Knowledge GraphInteractive network visualization of memory relationships
Smart AssemblerToken-budget assembly with 6 compressors
Secrets ScannerDetects API keys, passwords, tokens (OWASP patterns)
ProfilesFully isolated workspaces per project/client
ImportCLAUDE.md, Copilot instructions, SQLite databases
REST APIFull API for custom integrations

⁠Tags

TagDescription
latestLatest stable release
4.3.1Current version

⁠Volumes

PathPurpose
/dataDatabase, profiles, configs (persistent)
/mnt/docsOptional: local folder for indexing (read-only)

⁠Ports

PortService
8080Web UI + REST API
8400MCP streamable-http server

⁠Environment Variables

VariableDefaultDescription
CONTEXTPILOT_DATA_DIR/dataData directory inside container

⁠Tech Stack

Python 3.11+ · FastAPI · SQLite (WAL + FTS5) · Server-Sent Events · MCP (FastMCP) · tiktoken


⁠License

MIT License — free to use, modify, and distribute.

Source code: github.com/applehell/contextpilot⁠ Website: contextpilot.net⁠

Tag summary

Content type

Image

Digest

sha256:a627a95a5…

Size

139.5 MB

Last updated

2 months ago

docker pull applehell/contextpilot