zebbern

Knowledge Assistant

Name: Knowledge Assistant
Author: zebbern

AI community

SOURCE https://github.com/zebbern/knowledge-assistant

Description

A lightweight, no-cost, chat agent that answers questions from custom knowledge files. No vector databases, no embeddings, no complex setup - drop in your md files and start chatting

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Knowledge-Assistant

A lightweight, free, file-based chat agent that answers questions from your custom knowledge files. No vector databases, no embeddings, no complex setup - just drop in your markdown files and start chatting.

env variables needed: OPENROUTER_API_KEY, NEXT_PUBLIC_SITE_URL

Why Lightweight?

Unlike heavyweight RAG solutions that require:

Vector databases (Pinecone, Weaviate, Chroma)
Embedding models and preprocessing
Complex chunking strategies
Database hosting and maintenance

Knowledge-Assistant takes a simpler approach:

Just files - Drop .md or .txt files in a folder
No preprocessing - Files are read at request time
No database - Context goes directly to the LLM
Free models - Uses OpenRouter's free tier (Llama, Mimo, DeepSeek)

Perfect for: documentation sites, GitHub repos, personal knowledge bases, and projects where simplicity beats complexity.

Key Features

Multiple Free Models - Choose from Llama 3.3, Mimo, DeepSeek R1, Devstral, GLM
Temperature Control - Adjust creativity (0 = precise, 2 = creative)
Custom System Prompts - Add your own AI personality and instructions
Streaming Responses - Real-time token-by-token output
Markdown Rendering - Full markdown with syntax highlighting
Mermaid Diagrams - Live diagram rendering in chat
Code Blocks - Syntax-highlighted with copy functionality
Persistent Sessions - Conversations stored in localStorage
Export Chat - Download conversations as markdown