{"id":34036483,"url":"https://github.com/daved01/ragcore","last_synced_at":"2026-03-17T20:37:20.800Z","repository":{"id":209183789,"uuid":"675736970","full_name":"daved01/ragcore","owner":"daved01","description":"A library to build retrieval-augmented generation apps with just a few lines of code.","archived":false,"fork":false,"pushed_at":"2026-03-13T12:39:24.000Z","size":3587,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-14T01:21:51.776Z","etag":null,"topics":["artificial-intelligence","development","large-language-models","machine-learning","retrieval-augmented-generation"],"latest_commit_sha":null,"homepage":"https://daved01.github.io/ragcore/","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/daved01.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"daved01","custom":"https://www.paypal.com/donate/?hosted_button_id=JH7HXP6VE5U3S"}},"created_at":"2023-08-07T15:52:57.000Z","updated_at":"2026-03-13T12:38:43.000Z","dependencies_parsed_at":"2024-03-09T18:32:10.264Z","dependency_job_id":"9d503cc8-a156-4e72-ae18-d22819e9162a","html_url":"https://github.com/daved01/ragcore","commit_stats":null,"previous_names":["daved01/docucite"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/daved01/ragcore","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daved01%2Fragcore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daved01%2Fragcore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daved01%2Fragcore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daved01%2Fragcore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daved01","download_url":"https://codeload.github.com/daved01/ragcore/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daved01%2Fragcore/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30631403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T17:32:55.572Z","status":"ssl_error","status_checked_at":"2026-03-17T17:32:38.732Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["artificial-intelligence","development","large-language-models","machine-learning","retrieval-augmented-generation"],"created_at":"2025-12-13T20:26:13.062Z","updated_at":"2026-03-17T20:37:20.795Z","avatar_url":"https://github.com/daved01.png","language":"Python","funding_links":["https://github.com/sponsors/daved01","https://www.paypal.com/donate/?hosted_button_id=JH7HXP6VE5U3S"],"categories":[],"sub_categories":[],"readme":"# RAG Core\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.python.org/downloads/release/python-310/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.10-green.svg\" alt=\"Python 3.10\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.python.org/downloads/release/python-311/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.11-green.svg\" alt=\"Python 3.11\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-green.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/ragcore\"\u003e\u003cimg alt=\"PyPI - Version\" src=\"https://img.shields.io/pypi/v/ragcore?color=blue\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/daved01/ragcore/actions/workflows/code-check-main.yml/badge.svg\" alt=\"GitHub CI\"\u003e\n\u003c/p\u003e\n\nA Retrieval-Augmented Generation library with a CLI interface. Build RAG applications with just a few commands and a configuration file.\n\n## Supported setups\n\n| Databases               | LLMs           | Embeddings     | Document types  |\n| ----------------------- | -------------- | -------------- | --------------- |\n| Chroma (local)          | OpenAI         | OpenAI         | PDF             |\n| Pinecone (remote)       | AzureOpenAI    | AzureOpenAI    |                 |\n\nFor more details see the [documentation](https://daved01.github.io/ragcore/).\n\n# Installation\n\nTo install, run\n\n```bash\npip install ragcore\n```\n\nor clone and build from source\n\n```bash\ngit clone https://github.com/daved01/ragcore.git\ncd ragcore\npip install .\n```\n\nIf everything worked, running\n\n```bash\nragcore -h\n```\n\nshould show you some information about `ragcore`.\n\n# A Simple Example\n\nTo build an application with OpenAI or AzureOpenAI LLMs and embeddings, and a local database, first set your OpenAI [API key](https://platform.openai.com/api-keys) as described [here](https://platform.openai.com/docs/quickstart/step-2-setup-your-api-key):\n\n```bash\nexport OPENAI_API_KEY=[your token]\n```\n\nThen, create a config file `config.yaml` like this in the root of your project:\n\n```bash\ndatabase:\n  provider: \"chroma\"\n  number_search_results: 5\n  base_dir: \"data/database\"\n\nsplitter:\n  chunk_overlap: 256\n  chunk_size: 1024\n\nembedding:\n  provider: \"openai\"\n  model: \"text-embedding-model\"\n\nllm:\n  provider: \"openai\"\n  model: \"gpt-model\"\n\n```\n\nAnd finally, create your application using this config file:\n\n```python\nfrom ragcore import RAGCore\n\n\napp = RAGCore() # pass config=\u003cpath-to-config.yaml\u003e if not in root\n\n# Upload a document \"My_Book.pdf\"\napp.add(path=\"My_Book.pdf\")\n\n# Now you can ask questions\nanswer = app.query(query=\"What did the elk say?\")\n\nprint(answer.content)\n\n# List the document's title and content on which the response is based\nfor doc in answer.documents:\n  print(doc.title, \" | \", doc.content)\n\n# List all documents in the database\nprint(app.get_titles())\n\n# You can delete by title\napp.delete(title=\"My_Book\")\n```\n\nAnd that's it! For more information, as well as an overview of supported integrations check out the [documentation](https://daved01.github.io/ragcore/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaved01%2Fragcore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaved01%2Fragcore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaved01%2Fragcore/lists"}