{"id":26333050,"url":"https://github.com/astrabert/paperschat","last_synced_at":"2025-10-28T00:09:20.360Z","repository":{"id":277936026,"uuid":"933889283","full_name":"AstraBert/PapersChat","owner":"AstraBert","description":"An agentic AI application that allows you to chat with your papers and gather also information from papers on ArXiv and on PubMed","archived":false,"fork":false,"pushed_at":"2025-02-17T12:28:02.000Z","size":234,"stargazers_count":68,"open_issues_count":0,"forks_count":15,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-03T12:54:04.758Z","etag":null,"topics":["agent","agentic-ai","ai","arxiv","gradio","llamaindex","llamaparse","llm","mistral","papers","pubmed","qdrant","rag"],"latest_commit_sha":null,"homepage":"https://huggingface.co/spaces/as-cle-bert/PapersChat","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/AstraBert.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2025-02-16T22:49:11.000Z","updated_at":"2025-03-31T01:07:36.000Z","dependencies_parsed_at":"2025-02-17T04:41:03.155Z","dependency_job_id":"ccb5d8a0-d473-40ed-bc68-60df1937f58b","html_url":"https://github.com/AstraBert/PapersChat","commit_stats":null,"previous_names":["astrabert/paperschat"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstraBert%2FPapersChat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstraBert%2FPapersChat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstraBert%2FPapersChat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AstraBert%2FPapersChat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AstraBert","download_url":"https://codeload.github.com/AstraBert/PapersChat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248112587,"owners_count":21049675,"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","ai","arxiv","gradio","llamaindex","llamaparse","llm","mistral","papers","pubmed","qdrant","rag"],"created_at":"2025-03-15T23:37:55.189Z","updated_at":"2025-10-28T00:09:20.339Z","avatar_url":"https://github.com/AstraBert.png","language":"Python","funding_links":["https://github.com/sponsors/AstraBert"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003ePapersChat\u003c/h1\u003e\r\n\r\n\u003ch2 align=\"center\"\u003eChatting With Papers Made Easy\u003c/h2\u003e\r\n\r\n\u003ch3 align=\"center\"\u003eIf you find PapersChat useful, please consider to support us through donation:\u003c/h3\u003e\r\n\u003cdiv align=\"center\"\u003e\r\n    \u003ca href=\"https://github.com/sponsors/AstraBert\"\u003e\u003cimg src=\"https://img.shields.io/badge/sponsor-30363D?style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=#EA4AAA\" alt=\"GitHub Sponsors Badge\"\u003e\u003c/a\u003e\r\n\u003c/div\u003e\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n    \u003cimg src=\"logo.png\" alt=\"PapersChat Logo\" width=200 height=200\u003e\r\n\u003c/div\u003e\r\n\r\n**PapersChat** is an agentic AI application that allows you to chat with your papers and gather also information from papers on ArXiv and on PubMed. It is powered by [LlamaIndex](https://www.llamaindex.ai/), [Qdrant](https://qdrant.tech) and [Mistral AI](https://mistral.ai/en).\r\n\r\n### Flowchart\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n    \u003cimg src=\"flowchart.png\" alt=\"PapersChat Flowchart\"\u003e\r\n\u003c/div\u003e\r\n\r\n### Install and launch it\r\n\r\nThe installation of the application is a unique process, you simply have to clone the GitHub repository:\r\n\r\n```bash\r\ngit clone https://github.com/AstraBert/PapersChat.git\r\ncd PapersChat/\r\n```\r\n\r\nTo launch the app, you can follow two paths:\r\n\r\n**1. Docker (recommended)**\r\n\r\n\u003e _Required: [Docker](https://docs.docker.com/desktop/) and [docker compose](https://docs.docker.com/compose/)_\r\n\r\n- Add the `mistral_api_key`, `phoenix_api_key` and `llamacloud_api_key`  variables in the [`.env.example`](./docker/.env.example) file and modify the name of the file to `.env`. Get these keys:\r\n    + [On Mistral AI](https://console.mistral.ai/api-keys/)\r\n    + [On LlamaCloud](https://cloud.llamaindex.ai/)\r\n    + [On Phoenix/Arize](https://llamatrace.com/projects)\r\n\r\n```bash\r\n# modify your access token, e.g. hf_token=\"hf_abcdefg1234567\"\r\nmv .env.example .env\r\n```\r\n\r\n- Launch the docker application:\r\n\r\n```bash\r\n# If you are on Linux/macOS\r\nbash start_services.sh\r\n# If you are on Windows\r\n.\\start_services.ps1\r\n```\r\n\r\nYou will see the application running on http://localhost:7860 and you will be able to use it. Depending on your connection and on your hardware, the set up might take some time (up to 30 mins to set up) - but this is only for the first time your run it!\r\n\r\n**2. Source code**\r\n\r\n\u003e _Required: [Docker](https://docs.docker.com/desktop/), [docker compose](https://docs.docker.com/compose/) and [conda](https://anaconda.org/anaconda/conda)_\r\n\r\n- Add the `mistral_api_key`, `phoenix_api_key` and `llamacloud_api_key`  variables in the [`.env.example`](./docker/.env.example) file and modify the name of the file to `.env`. Get these keys:\r\n    + [On Mistral AI](https://console.mistral.ai/api-keys/)\r\n    + [On LlamaCloud](https://cloud.llamaindex.ai/)\r\n    + [On Phoenix/Arize](https://llamatrace.com/projects)\r\n\r\n```bash\r\nmv .env.example .env\r\n# modify the variables, e.g.:\r\n# llamacloud_api_key=\"llx-000-abc\"\r\n# mistral_api_key=\"01234abc\"\r\n# phoenix_api_key=\"56789def\"\r\n```\r\n\r\n- Alternatively, if you wish to use Azure OpenAI or Ollama, specify:\r\n\r\n```bash\r\nazure_openai_api_key=\"***\" # if you wish to use Azure OpenAI\r\nollama_model=\"gemma3:latest\" # if you wish to use Ollama\r\n```\r\n\r\n\u003e[!IMPORTANT]\r\n\u003e _This is only possible while launching from source code, Docker launching does not support this option_\r\n\r\n- Set up PapersChat using the dedicated script:\r\n\r\n```bash\r\n# For MacOs/Linux users\r\nbash local_setup.sh\r\n# For Windows users\r\n.\\local_setup.ps1\r\n```\r\n\r\n- Or you can do it manually, if you prefer:\r\n\r\n```bash\r\ndocker compose up db -d\r\n\r\nconda env create -f environment.yml\r\n\r\nconda activate papers-chat\r\npython3 scripts/app.py\r\nconda deactivate\r\n```\r\n\r\n## Contributing\r\n\r\nContributions are always welcome! Follow the contributions guidelines reported [here](CONTRIBUTING.md).\r\n\r\n## License and rights of usage\r\n\r\nThe software is provided under MIT [license](./LICENSE).\r\n\r\n### Full documentation will come soon!👷‍♀️\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrabert%2Fpaperschat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastrabert%2Fpaperschat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastrabert%2Fpaperschat/lists"}