Chipper gives you a web interface, CLI, and a hackable, simple architecture for embedding pipelines, document chunking, web scraping, and query workflows. Built with Haystack, Ollama, Hugging Face, Docker, Tailwind, and ElasticSearch, it runs locally or scales as a Dockerized service.

This project started as a way to help my girlfriend with her new book. The idea was to use local RAG and LLMs to ask questions about characters and explore creative possibilities, all without sharing proprietary details or your own book with cloud services like ChatGPT. What began as a bunch of scripts is now growing into a fully dockerized service architecture.

If you like what you see, leaving a star would be sweet and will help more people discover Chipper!

Check out the live demo: https://demo.chipper.tilmangriesel.com/

Features

• Local Ollama and hosted Hugging Face API
• Build a powerful knowledge base using ElasticSearch embeddings.
• Automatically split documents via Haystack.
• Scrape content from web sources.
• Transcribe audio files into text.
• Access via a user-friendly CLI or web client interface.
• Deploy effortlessly using Docker.

Installation and Setup

Visit the Chipper project website for detailed setup instructions.

Note: This is just a research project, so it's not built for production.

Philosophy

At the heart of this project lies my passion for education and exploration. I believe in creating tools that are both approachable for beginners and helpful for experts. My goal is to offer you a well-thought-out service architecture, and a stepping stone for those eager to learn and innovate.

This project wants to be more than just a technical foundation, for educators, it provides a framework to teach AI concepts in a manageable and practical way. For explorers, tinkerers and companies, it offers a playground where you can experiment, iterate, and build upon a versatile platform.

Feel free to improve, fork, copy, share or expand this project. Contributions are always very welcome!

Demo

Roadmap

• Basic functionality
• CLI
• Web UI
• Docker
• Improved Web UI with better mobile support
• Improve linting and formatting
• Docker Hub registry images
• Edge inference TTS
• Automated unit-tests
• React based web app
• Smart document chunking and embedding

---

Acknowledgments

• Haystack
• Ollama
• Hugging Face
• Elastic
• Elasticvue
• Docker
• VitePress
• Sherpa ONNX
• Sherpa ONNX Wasm

Star History

---

Be sure to visit the Chipper project website for detailed setup instructions and more information.