{"id":29873137,"url":"https://github.com/ricard1406/little_agent_chatbot","last_synced_at":"2026-03-09T16:23:38.464Z","repository":{"id":304198059,"uuid":"1017583381","full_name":"ricard1406/Little_Agent_Chatbot","owner":"ricard1406","description":"Simple little agent RAG chatbot based on Ollama, qwen3, Langchain, Gradio. ","archived":false,"fork":false,"pushed_at":"2025-07-29T19:55:27.000Z","size":6558,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-29T22:07:16.534Z","etag":null,"topics":["agent","chatbot","gradio","granite","langchain","llama3","llm","ollama","python","qwen","rag","simple"],"latest_commit_sha":null,"homepage":"https://ricard1406.github.io/Little_Agent_Chatbot/","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/ricard1406.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-07-10T19:01:57.000Z","updated_at":"2025-07-29T19:55:31.000Z","dependencies_parsed_at":"2025-07-11T17:33:19.273Z","dependency_job_id":"634621a0-5a00-43a5-a628-034a5f5ca55f","html_url":"https://github.com/ricard1406/Little_Agent_Chatbot","commit_stats":null,"previous_names":["ricard1406/little_agent_chatbot"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ricard1406/Little_Agent_Chatbot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricard1406%2FLittle_Agent_Chatbot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricard1406%2FLittle_Agent_Chatbot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricard1406%2FLittle_Agent_Chatbot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricard1406%2FLittle_Agent_Chatbot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ricard1406","download_url":"https://codeload.github.com/ricard1406/Little_Agent_Chatbot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ricard1406%2FLittle_Agent_Chatbot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267951751,"owners_count":24171094,"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-07-30T02:00:09.044Z","response_time":70,"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":["agent","chatbot","gradio","granite","langchain","llama3","llm","ollama","python","qwen","rag","simple"],"created_at":"2025-07-30T22:16:03.591Z","updated_at":"2026-03-09T16:23:38.436Z","avatar_url":"https://github.com/ricard1406.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Little Agent Chatbot 🤖\n\n- A lightweight local AI agent chatbot powered by Ollama and LangChain/LangGraph with RAG capabilities.\n- Tested LLM: qwen3:1.7b; qwen3:4b; granite3.3:2b; llama3.2:3b; cogito:3b\n- Dual provider support: a) local Ollama LLM b) remote Claude LLM (API-key required) \n- Tested on low-budget hardware 8GB RAM.\n- Included tools: real time weather, calculate, local documents RAG, local SQL database query and update.\n\n## 🌟 Overview\n\nLittle Agent Chatbot is a simple yet powerful local AI assistant that runs entirely on your machine. Built for learning and experimentation, it combines the power of LLMs with advanced retrieval-augmented generation (RAG) to create an intelligent chatbot that can work with your personal documents and provide real-time information.\n\n## ✨ Key Features\n\n- **🏠 Fully Local**: Runs completely on your machine - no data leaves your device\n- **💰 Budget-Friendly**: Works on low-resource hardware using efficient models.\n- **🏠 Dual provider**: a) local Ollama LLM b) remote Claude LLM (API-key required)\n- **📚 RAG Integration**: Upload and chat with your PDF documents using ChromaDB and Nomic embeddings\n- **🌐 Real-Time Data**: Get live weather information and perform calculations\n- **🔧 Agent Framework**: Extensible agent system built with Langchain\n- **💻 Easy Interface**: Clean web interface powered by Gradio\n- **💻 Interface Options**: Graphic web interface or classic text interface.\n- **🔓 Open Source**: MIT licensed and fully customizable\n\n## 🚀 Tech Stack\n\n- **LLM Backend**: [Ollama](https://ollama.ai/) with Qwen3 model (1.7B or 4B variants)\n- **Agent Framework**: [Langchain](https://python.langchain.com/) ecosystem\n- **Vector Database**: [ChromaDB](https://www.trychroma.com/) for document embeddings\n- **Embeddings**: Nomic-embed-text for semantic search\n- **Document Processing**: PyPDF, Unstructured, TikToken\n- **Web Interface**: [Gradio](https://gradio.app/)\n- **Language**: Python\n- **License**: MIT\n\n## 🎯 What Makes This Special?\n\n- **Privacy First**: Your conversations and documents stay on your device\n- **Cost Effective**: No API costs - runs on your hardware\n- **Educational**: Perfect for learning about AI agents and RAG systems\n- **Extensible**: Easy to modify and add new capabilities\n- **Lightweight**: Designed to work on modest hardware setups\n\n## 📖 Usage\n\n### Basic Chat\nSimply type your questions and the AI will respond using the local Qwen3 model.\n\n### Document Upload\nUpload PDF documents to enable RAG functionality. The chatbot will be able to answer questions based on your documents.\n\n### Agent Capabilities\n- **Weather Information**: Get real-time weather data\n- **Calculations**: Perform mathematical operations\n- **Document Q\u0026A**: Query your uploaded PDFs\n\n## 🏗️ Architecture\n\n```\nUser Input → Gradio Interface → Langchain Agent → Ollama/Qwen3 → Response\n                                      ↓\n                              RAG System (PDF Documents)\n                                      ↓\n                              External Tools (Weather, Calculator)\n```\n\n## 🔧 Configuration\n\nCustomize the chatbot by modifying:\n- Model parameters in `config.py`\n- Agent tools and capabilities\n- UI appearance and behavior\n- RAG document processing settings\n\n## 🤝 Contributing\n\nContributions are welcome! This project is designed for learning and experimentation. Feel free to:\n- Add new agent capabilities\n- Improve the UI/UX\n- Enhance document processing\n- Add new LLM models\n- Fix bugs and improve performance\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🎓 Educational Purpose\n\nThis project is perfect for:\n- Learning about AI agents and RAG systems\n- Understanding local LLM deployment\n- Experimenting with Langchain framework\n- Building privacy-focused AI applications\n- Exploring document-based AI interactions\n\n## 🔮 Future Enhancements\n\n- Support for more document formats\n- Additional agent tools and capabilities\n- Multi-language support\n- Voice interface integration\n- Mobile-friendly interface\n\n## 📞 Support\n\nIf you encounter issues or have questions:\n- Open an issue on GitHub\n- Check the documentation\n- Review the example configurations\n\n## 🌟 Star the Project\n\nIf you find this project helpful, please give it a star! It helps others discover the project and motivates continued development.\n\n---\n\n**Made with ❤️ for the AI community**\n\n*Happy chatting with your local AI agent!* 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fricard1406%2Flittle_agent_chatbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fricard1406%2Flittle_agent_chatbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fricard1406%2Flittle_agent_chatbot/lists"}