{"id":31693762,"url":"https://github.com/yahya-py/ollama-llm-rag-chatbot","last_synced_at":"2026-04-14T23:33:17.766Z","repository":{"id":316901147,"uuid":"1029264855","full_name":"Yahya-py/OLLAMA-LLM-RAG-Chatbot","owner":"Yahya-py","description":"Local AI chatbot using LLaMA3 + personal data with LangChain, Chroma \u0026 Gradio UI","archived":false,"fork":false,"pushed_at":"2025-07-31T09:14:08.000Z","size":1173,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-27T13:29:20.683Z","etag":null,"topics":["chatbot","gradio","langchain","llama3","local","localllm","python"],"latest_commit_sha":null,"homepage":"https://github.com/Yahya-py/OLLAMA-LLM-RAG-Chatbot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Yahya-py.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-30T19:14:47.000Z","updated_at":"2025-07-31T09:14:12.000Z","dependencies_parsed_at":"2025-09-27T13:29:27.593Z","dependency_job_id":"79ee801f-ad15-40e3-aa4d-cfa97ec05ac3","html_url":"https://github.com/Yahya-py/OLLAMA-LLM-RAG-Chatbot","commit_stats":null,"previous_names":["yahya-py/ollama-llm-rag-chatbot"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Yahya-py/OLLAMA-LLM-RAG-Chatbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yahya-py%2FOLLAMA-LLM-RAG-Chatbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yahya-py%2FOLLAMA-LLM-RAG-Chatbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yahya-py%2FOLLAMA-LLM-RAG-Chatbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yahya-py%2FOLLAMA-LLM-RAG-Chatbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Yahya-py","download_url":"https://codeload.github.com/Yahya-py/OLLAMA-LLM-RAG-Chatbot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yahya-py%2FOLLAMA-LLM-RAG-Chatbot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278972328,"owners_count":26078017,"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","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["chatbot","gradio","langchain","llama3","local","localllm","python"],"created_at":"2025-10-08T15:53:01.549Z","updated_at":"2025-10-08T15:53:07.566Z","avatar_url":"https://github.com/Yahya-py.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Smart AI Chatbot with Local LLM + Personal Data\n\nThis project is a lightweight, fully functional AI chatbot built with **Gradio**, **LangChain**, and **Ollama**. It supports both general-purpose chatting using local LLMs (like `llama3.2`) and personalized answers based on your own uploaded documents — all without relying on cloud APIs like OpenAI or Cohere.\n\nSmart AI Chatbot built on LLaMA3 using LangChain, ChromaDB, and Gradio. Supports real-time chat with optional retrieval-augmented responses from your own documents. 100% offline and privacy-first — perfect for developers, researchers, and businesses\n\n---\n\n## 🔍 Features\n\n- 🧠 **Local LLM** (e.g. `llama3.2`) powered via [Ollama](https://ollama.com/)\n- 📚 **Document-aware Q\u0026A** using `langchain` + `Chroma` vector DB\n- 💬 **Gradio Interface** with full chat history\n- 🖼️ Custom branding with logo and responsive UI\n- ✅ Toggle between general chatbot and personal knowledge base\n- 🔒 Runs 100% offline — fully private and secure\n\n---\n\n## 📸 Preview\n\n![chatbot interface](./image.png)\n\n---\n\n## 🚀 How It Works\n\n| Mode | Description |\n|------|-------------|\n| **General Mode** | Chatbot answers general questions using your chosen local LLM |\n| **Personal Data Mode** | It retrieves relevant info from your uploaded `.txt` files before generating a response |\n\n---\n\n## 🛠️ Installation\n\n### 1. Clone this repository\n\n```bash\ngit clone https://github.com/Yahya-py/OLLAMA-LLM-RAG-Chatbot.git\ncd OLLAMA-LLM-RAG-Chatbot\n```\n\n### 2. Install requirements\n\n```bash\npip install -r requirements.txt\n```\n\n### 3. Install and Run Ollama\n\n```bash\nollama pull llama3.2\nollama run llama3.2\n```\n\n---\n\n## 📁 Directory Structure\n\n```\nOLLAMA-LLM-RAG-Chatbot/\n├── chatbot_ollama_rag_llama32.py     # Main Python script\n├── image.png                         # Logo for chatbot UI\n├── data/                             # Folder containing user documents (.txt)\n├── chroma_db/                        # Persisted vector DB (auto-generated)\n└── requirements.txt\n```\n\n---\n\n## ⚙️ Usage\n\n```bash\npython chatbot_ollama_rag_llama32.py\n```\n\nVisit [http://127.0.0.1:7860](http://127.0.0.1:7860) in your browser.\n\nYou can:\n- Type your question\n- Check \"Use Personal Documents?\" to answer from your documents\n- View full chat history in real-time\n\n---\n\n## 🧠 Customize\n\n- Replace `image.png` with your own brand logo\n- Add `.pdf`, `.docx`, or `.md` support using `langchain` loaders\n- Train or fine-tune your own model using [Ollama fine-tune](https://ollama.com/blog/fine-tune-your-own-model)\n\n---\n\n## 🔐 Privacy Note\n\nThis project **does not send any data to the cloud**. All inference and document processing are done locally.\n\n---\n\n## 🏷️ Tags\n\n```\npython, chatbot, langchain, gradio, ollama, llama3, chromadb, local-llm, document-chatbot, AI-portfolio\n```\n\n---\n\n## 📃 License\n\nMIT License — free to use, modify, and share.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyahya-py%2Follama-llm-rag-chatbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyahya-py%2Follama-llm-rag-chatbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyahya-py%2Follama-llm-rag-chatbot/lists"}