{"id":14964911,"url":"https://github.com/amithkoujalgi/ollama-pdf-bot","last_synced_at":"2025-10-09T17:35:19.753Z","repository":{"id":206542468,"uuid":"717141685","full_name":"amithkoujalgi/ollama-pdf-bot","owner":"amithkoujalgi","description":"A bot that accepts PDF docs and lets you ask questions on it.","archived":false,"fork":false,"pushed_at":"2025-02-17T17:42:37.000Z","size":8752,"stargazers_count":209,"open_issues_count":7,"forks_count":54,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-10-07T10:12:42.291Z","etag":null,"topics":["bot","chat-bot","llama","llama2","llm","ollama","pdf","pdf-bot"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/amithkoujalgi/pdf-bot","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/amithkoujalgi.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}},"created_at":"2023-11-10T16:48:03.000Z","updated_at":"2025-10-03T21:37:43.000Z","dependencies_parsed_at":"2023-11-10T18:29:33.519Z","dependency_job_id":"46dbfa0f-8e6a-4ae9-b357-66f68b0bb8c4","html_url":"https://github.com/amithkoujalgi/ollama-pdf-bot","commit_stats":{"total_commits":48,"total_committers":2,"mean_commits":24.0,"dds":0.4375,"last_synced_commit":"8b1e13693b4386ed37c0d4eb095c152e525eecae"},"previous_names":["amithkoujalgi/ollama-pdf-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/amithkoujalgi/ollama-pdf-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amithkoujalgi%2Follama-pdf-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amithkoujalgi%2Follama-pdf-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amithkoujalgi%2Follama-pdf-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amithkoujalgi%2Follama-pdf-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amithkoujalgi","download_url":"https://codeload.github.com/amithkoujalgi/ollama-pdf-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amithkoujalgi%2Follama-pdf-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278802801,"owners_count":26048566,"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-07T02:00:06.786Z","response_time":59,"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":["bot","chat-bot","llama","llama2","llm","ollama","pdf","pdf-bot"],"created_at":"2024-09-24T13:33:57.638Z","updated_at":"2025-10-09T17:35:19.734Z","avatar_url":"https://github.com/amithkoujalgi.png","language":"Python","funding_links":["https://www.buymeacoffee.com/amithkoujalgi","https://ko-fi.com/amithkoujalgi"],"categories":[],"sub_categories":[],"readme":"### PDF Bot with Ollama\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"15%\" src=\"https://raw.githubusercontent.com/amithkoujalgi/ollama-pdf-bot/main/.demo-stuff/logo.jpeg\"/\u003e\n\u003c/p\u003e\n\nA bot that accepts PDF docs and lets you ask questions on it.\n\nThe LLMs are downloaded and served via [Ollama](https://github.com/jmorganca/ollama).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/docker/pulls/amithkoujalgi/pdf-bot?style=for-the-badge\u0026link=https%3A%2F%2Fhub.docker.com%2Fr%2Famithkoujalgi%2Fpdf-bot\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/amithkoujalgi/ollama-pdf-bot?style=social\"/\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/amithkoujalgi/ollama-pdf-bot?style=social\"/\u003e\n  \u003cimg src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Famithkoujalgi%2Follama-pdf-bot\u0026count_bg=%2379C83D\u0026title_bg=%23555555\u0026icon=\u0026icon_color=%23E7E7E7\u0026title=hits\u0026edge_flat=false\"/\u003e\n\n\u003c/p\u003e\n\u003c!-- ![GitHub stars](https://img.shields.io/github/stars/amithkoujalgi/ollama-pdf-bot?style=social)\n![GitHub forks](https://img.shields.io/github/forks/amithkoujalgi/ollama-pdf-bot?style=social)\n![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Famithkoujalgi%2Follama-pdf-bot\u0026count_bg=%2379C83D\u0026title_bg=%23555555\u0026icon=\u0026icon_color=%23E7E7E7\u0026title=hits\u0026edge_flat=false)\n --\u003e\n\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [How to run](#how-to-run)\n- [Demo](#demo)\n- [Improvements](#improvements)\n- [Contributing](#contributing)\n- [Credits](#credits)\n\n### Requirements\n\n[![][shield]][site]\n\n[![][maketool-shield]][maketool-site]\n\n[site]: https://docs.docker.com/compose/\n\n[shield]: https://img.shields.io/badge/Docker_Compose-Installation-blue.svg?style=for-the-badge\u0026labelColor=gray\n\n[maketool-site]: https://www.gnu.org/software/make/\n\n[maketool-shield]: https://img.shields.io/badge/Make-Tool-blue.svg?style=for-the-badge\u0026labelColor=gray\n\n### How to run\n\n#### CPU version\n\n```shell\nmake start\n```\n\n#### GPU version\n\n```shell\nmake start-gpu\n```\n\nWhen the server is up and running, access the app at: http://localhost:8501\n\nSwitch to a different model by changing the `MODEL` env variable in the [docker-compose.yaml](https://github.com/amithkoujalgi/ollama-pdf-bot/blob/main/docker-compose.yml#L18). Check out the available models from [here](https://ollama.ai/library).\n\n**Note:**\n\n- It takes a while to start up since it downloads the specified model for the first time.\n- If your hardware does not have a GPU and you choose to run only on CPU, expect high response time from the bot.\n- Only Nvidia is supported as mentioned in Ollama's documentation. Others such as AMD isn't supported yet. Read how to\n  use GPU on [Ollama container](https://hub.docker.com/r/ollama/ollama)\n  and [docker-compose](https://docs.docker.com/compose/gpu-support/#:~:text=GPUs%20are%20referenced%20in%20a,capabilities%20.).\n- Make sure to have Nvidia drivers setup on your execution environment for the best results.\n\nImage on DockerHub: https://hub.docker.com/r/amithkoujalgi/pdf-bot\n\n### [Demo](https://www.youtube.com/watch?v=jJyFslR-oNQ)\n\nhttps://github.com/amithkoujalgi/ollama-pdf-bot/assets/1876165/40dc70e6-9d35-4171-9ae6-d82247dbaa17\n\n#### Sample PDFs\n\n[Hl-L2351DW v0522.pdf](https://github.com/amithkoujalgi/ollama-pdf-bot/files/13323209/Hl-L2351DW.v0522.pdf)\n\n[HL-B2080DW v0522.pdf](https://github.com/amithkoujalgi/ollama-pdf-bot/files/13323208/HL-B2080DW.v0522.pdf)\n\n\n### Improvements\n\n- [ ] Expose model params such as `temperature`, `top_k`, `top_p` as configurable env vars\n\n### Contributing\n\nContributions are most welcome! Whether it's reporting a bug, proposing an enhancement, or helping\nwith code - any sort of contribution is much appreciated.\n\n#### Requirements\n\n![Python](https://img.shields.io/badge/python-3.8_+-green.svg)\n\n#### Setup Ollama server for development\n\n```shell\ndocker run -it -v ~/ollama:/root/.ollama -p 11434:11434 ollama/ollama\n```\n\n#### Install the libs\n\n```shell\npip install -r requirements.txt\n```\n\n#### Start the app\n\n```shell\nstreamlit run pdf_bot/app.py\n```\n\n### Credits\n\nThanks to the incredible [Ollama](https://github.com/jmorganca/ollama), [Langchain](https://www.langchain.com/)\nand [Streamlit](https://streamlit.io/) projects.\n\n### Appreciate my work?\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.buymeacoffee.com/amithkoujalgi\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n  \u003c!--\u003ca href=\"https://ko-fi.com/amithkoujalgi\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.prod.website-files.com/5c14e387dab576fe667689cf/64f1a9ddd0246590df69e9f9_ko-fi_logo_03.png\" alt=\"Show support\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e--\u003e\n\u003c/p\u003e\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famithkoujalgi%2Follama-pdf-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famithkoujalgi%2Follama-pdf-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famithkoujalgi%2Follama-pdf-bot/lists"}