https://github.com/tilmangriesel/chipper
✨ AI interface for tinkerers (Ollama, Haystack RAG, Python)
https://github.com/tilmangriesel/chipper
agent agentic-ai deepseek deepseek-chat deepseek-r1 embedding hugging-face huggingface llama3 llm llm-inference ollama ollama-api ollama-client ollama-gui phi4 rag retrival-augmented-generation
Last synced: 4 days ago
JSON representation
✨ AI interface for tinkerers (Ollama, Haystack RAG, Python)
- Host: GitHub
- URL: https://github.com/tilmangriesel/chipper
- Owner: TilmanGriesel
- License: mit
- Created: 2024-12-22T17:54:13.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-13T20:36:30.000Z (6 days ago)
- Last Synced: 2025-05-16T05:04:45.372Z (4 days ago)
- Topics: agent, agentic-ai, deepseek, deepseek-chat, deepseek-r1, embedding, hugging-face, huggingface, llama3, llm, llm-inference, ollama, ollama-api, ollama-client, ollama-gui, phi4, rag, retrival-augmented-generation
- Language: Python
- Homepage: https://chipper.tilmangriesel.com/
- Size: 84.4 MB
- Stars: 447
- Watchers: 6
- Forks: 42
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
**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](https://ollama.com/) and [hosted Hugging Face API](https://huggingface.co/)
- 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](https://chipper.tilmangriesel.com/) 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
- [x] Basic functionality
- [x] CLI
- [x] Web UI
- [x] Docker
- [x] Improved Web UI with better mobile support
- [x] Improve linting and formatting
- [ ] React based web app
- [ ] CI test
- [x] Docker Hub registry images
- [ ] Smart document chunking and embedding
---
## Special Thanks
A huge shoutout and heartfelt thanks to all the incredible projects that make Chipper possible:
- [Haystack](https://haystack.deepset.ai/) for providing the foundation for embedding and retrieval.
- [Ollama](https://ollama.com/) for their amazing models and project.
- [Hugging Face](https://huggingface.co/) for the ease of use.
- [Elastic](https://www.elastic.co) and [Elasticvue](https://elasticvue.com/) for powering fast and efficient data retrieval.
- [Docker](https://docker.com) for simplifying deployment and making setup a breeze.
- [VitePress](https://vitepress.dev/), just the most lovely static site generator.
These projects are the backbone of Chipper, and their contributions inspire endless possibilities.
## Star History
---
Be sure to visit the [Chipper project website](https://chipper.tilmangriesel.com/) for detailed setup instructions and more information.