{"id":23454856,"url":"https://github.com/tilmangriesel/chipper","last_synced_at":"2025-05-16T05:04:52.199Z","repository":{"id":269336254,"uuid":"907063944","full_name":"TilmanGriesel/chipper","owner":"TilmanGriesel","description":"✨ AI interface for tinkerers (Ollama, Haystack RAG, Python)","archived":false,"fork":false,"pushed_at":"2025-05-13T20:36:30.000Z","size":88535,"stargazers_count":447,"open_issues_count":2,"forks_count":42,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-05-16T05:04:45.372Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://chipper.tilmangriesel.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TilmanGriesel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"buy_me_a_coffee":"griesel"}},"created_at":"2024-12-22T17:54:13.000Z","updated_at":"2025-05-15T23:19:39.000Z","dependencies_parsed_at":"2024-12-22T20:32:23.647Z","dependency_job_id":"076f8847-f607-45ab-8e00-fa923d1b3617","html_url":"https://github.com/TilmanGriesel/chipper","commit_stats":null,"previous_names":["tilmangriesel/chipper"],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TilmanGriesel%2Fchipper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TilmanGriesel%2Fchipper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TilmanGriesel%2Fchipper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TilmanGriesel%2Fchipper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TilmanGriesel","download_url":"https://codeload.github.com/TilmanGriesel/chipper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254471060,"owners_count":22076585,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-12-24T03:14:50.438Z","updated_at":"2025-05-16T05:04:47.187Z","avatar_url":"https://github.com/TilmanGriesel.png","language":"Python","funding_links":["https://buymeacoffee.com/griesel"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/TilmanGriesel/chipper/refs/heads/main/docs/public/assets/banner.png\" width=\"640\" alt=\"Logo Chipper RAG Util\"/\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://chipper.tilmangriesel.com/\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/TilmanGriesel/chipper/.github%2Fworkflows%2Fdocs-deploy.yml?colorA=1F2229\u0026colorB=ffffff\u0026style=for-the-badge\u0026label=GitHub Pages\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/TilmanGriesel/chipper/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/TilmanGriesel/chipper/.github%2Fworkflows%2Fpublish-docker.yml?colorA=1F2229\u0026colorB=ffffff\u0026style=for-the-badge\u0026label=DockerHub\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/tilmangriesel/chipper/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/tilmangriesel/chipper?colorA=1F2229\u0026colorB=ffffff\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/tilmangriesel/chipper/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/tilmangriesel/chipper?colorA=1F2229\u0026colorB=ffffff\u0026style=for-the-badge\"\u003e\u003c/a\u003e\u003ca href=\"https://hub.docker.com/repository/docker/griesel/chipper\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/griesel/chipper?colorA=1F2229\u0026colorB=ffffff\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**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.\n\nThis 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.\n\nIf you **like what you see, leaving a star would be sweet** and will help more people discover Chipper!\n\nCheck out the **live demo**: https://demo.chipper.tilmangriesel.com/\n\n## Features\n\n- Local [Ollama](https://ollama.com/) and [hosted Hugging Face API](https://huggingface.co/)\n- Build a powerful knowledge base using ElasticSearch embeddings.\n- Automatically split documents via Haystack.\n- Scrape content from web sources.\n- Transcribe audio files into text.\n- Access via a user-friendly CLI or web client interface.\n- Deploy effortlessly using Docker.\n\n## Installation and Setup\n\nVisit the [Chipper project website](https://chipper.tilmangriesel.com/) for detailed setup instructions.\n\n**Note:** This is just a research project, so it's not built for production.\n\n## Philosophy\n\nAt 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.\n\nThis 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.\n\nFeel free to improve, fork, copy, share or expand this project. Contributions are always very welcome!\n\n## Demo\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/TilmanGriesel/chipper/refs/heads/main/docs/public/assets/chipper_demo_01.gif\"alt=\"Chipper RAG Util Demo Browser\"/\u003e\u003c/p\u003e\n\n## Roadmap\n\n- [x] Basic functionality\n- [x] CLI\n- [x] Web UI\n- [x] Docker\n- [x] Improved Web UI with better mobile support\n- [x] Improve linting and formatting\n- [ ] React based web app\n- [ ] CI test\n- [x] Docker Hub registry images\n- [ ] Smart document chunking and embedding\n\n---\n\n## Special Thanks\n\nA huge shoutout and heartfelt thanks to all the incredible projects that make Chipper possible:\n\n- [Haystack](https://haystack.deepset.ai/) for providing the foundation for embedding and retrieval.\n- [Ollama](https://ollama.com/) for their amazing models and project.\n- [Hugging Face](https://huggingface.co/) for the ease of use.\n- [Elastic](https://www.elastic.co) and [Elasticvue](https://elasticvue.com/) for powering fast and efficient data retrieval.\n- [Docker](https://docker.com) for simplifying deployment and making setup a breeze.\n- [VitePress](https://vitepress.dev/), just the most lovely static site generator.\n\nThese projects are the backbone of Chipper, and their contributions inspire endless possibilities.\n\n## Star History\n\n\u003ca href=\"https://star-history.com/#TilmanGriesel/chipper\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=TilmanGriesel/chipper\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=TilmanGriesel/chipper\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=TilmanGriesel/chipper\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n---\n\nBe sure to visit the [Chipper project website](https://chipper.tilmangriesel.com/) for detailed setup instructions and more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftilmangriesel%2Fchipper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftilmangriesel%2Fchipper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftilmangriesel%2Fchipper/lists"}