afonsoft/knowledgerag repository overview

⁠Knowledge MCP Hub

All-in-one standalone agentic-RAG platform in a single container (.NET 10 / Kestrel): Blazor WebAssembly admin UI + REST management API + native MCP server (Streamable HTTP + legacy SSE). Point your AI agents and apps at the knowledge you already have — Obsidian vaults, web pages, documents, APIs, SQL databases, cloud storage, RSS, YouTube and Git repositories.

⁠Quick start

docker pull afonsoft/knowledgerag

docker run -d --name knowledgerag \
  -p 5000:8080 \
  -v knowledgerag-data:/data \
  -v vault:/vaults/default -e Vault__Path=/vaults/default \
  afonsoft/knowledgerag

• Admin UI: http://localhost:5000 — sign in admin / 123qwe (forced password change on first login; override the seed via Auth__AdminInitialPassword).
• MCP endpoint for agents: http://localhost:5000/mcp (Streamable HTTP) or /mcp/sse (legacy SSE) — Authorization: Bearer aft_* (generate keys at /api-keys in the UI).
• Health probe: GET /health/ready (already wired as the image HEALTHCHECK).

The same image is also on GHCR: docker pull ghcr.io/afonsoft/knowledgerag.

⁠What you get

• Dynamic MCP tool catalog — search_knowledge, ask_knowledge, agent_chat, read_document, write_knowledge/write_note, GraphRAG tools (find_dependencies, find_dependents, analyze_impact, temporal search_graph_*), plus upstream proxies (DeepWiki, Firecrawl, Tavily, Context7) and arbitrary McpProxy sources.
• Hybrid retrieval — FTS5 + sqlite-vec/pgvector fused with RRF, MMR diversification, corrective-RAG grading/retry/abstain, history-aware rewrite, multi-query/HyDE expansion, window retrieval with autocut.
• Connectors — Obsidian (local/WebDAV), WebPage, DocumentFile, Notion, RestApi, SqlDatabase (SELECT-only, guarded), S3/Azure Files/OCI Object Storage, RSS/Atom, YouTube transcripts, GitRepository, UnstructuredDocument OCR, AudioTranscription.
• Agentic loop — tool-calling with chain AST, HITL approvals, SSE streaming, conversation threads, per-key chat/embeddings settings.
• Pluggable embeddings & stores — deterministic (zero-infra), Ollama, OpenAI-compatible, Voyage, Cohere, local ONNX (all-MiniLM-L6-v2); SQLite or Postgres/pgvector backend.
• Ops built-in — EF Core migrations at startup, Serilog structured logs with secret redaction, OpenTelemetry traces/metrics, health checks, backup/restore scripts, PWA admin with live MCP monitor (SignalR).

⁠Ports & volumes

⁠Common environment variables

All ASP.NET Core settings accept Section__Key env vars. Frequently used:

Reaching services on the Docker host (Ollama, Postgres, Redis): add --add-host=host.docker.internal:host-gateway on docker run.

⁠Docker Compose

services:
  knowledgerag:
    image: afonsoft/knowledgerag:latest
    ports: ["5000:8080"]
    volumes: ["./data:/data", "./logs:/app/logs", "vault:/vaults/default"]
    environment:
      Vault__Path: /vaults/default
      Chat__Provider: ollama
      Chat__Endpoint: http://host.docker.internal:11434
      Chat__Model: llama3.1
      Embeddings__Provider: ollama
      Embeddings__Endpoint: http://host.docker.internal:11434
      Embeddings__Model: nomic-embed-text
    extra_hosts: ["host.docker.internal:host-gateway"]
    restart: unless-stopped
volumes:
  vault:
    name: vault

⁠Tags

• latest — most recent stable release
• X.Y.Z — immutable release tags (e.g. 0.1.1), published on every vX.Y.Z Git tag

⁠Links

• Source & docs: github.com/afonsoft/KnowledgeRAG⁠
• Install guide: docs/en/INSTALL.md⁠ · pt-BR⁠
• License: MIT — © Afonso Dutra Nogueira Filho, 2026