Skip to main content

GRAG - Good RAG

GitHub License Linting GitHub Actions Workflow Status Static Badge Static Badge Static Badge Static Badge Static Badge GitHub Issues or Pull Requests PyPI - Downloads

Static Badge Static Badge

GRAG is a simple python package that provides an easy end-to-end solution for implementing Retrieval Augmented Generation (RAG).

The package offers an easy way for running various LLMs locally, Thanks to LlamaCpp and also supports vector stores like Chroma and DeepLake. It also makes it easy to integrage support to any vector stores easy.

Diagram of a basic RAG pipeline
Diagram of a basic RAG pipeline

Table of Content

Project Overview

  • A ready to deploy RAG pipeline for document retrival.
  • Basic GUI (Under Development)
  • Evaluation Suite (Under Development)
  • RAG enhancement using Graphs (Under Development)

Getting Started

To run the projects, make sure the instructions below are followed.

Further customization can be made on the config file, src/config.ini.

  • git clone the repository
  • pip install . from the repository (note: add - then change directory to the cloned repo)
  • For Dev: pip install -e .

Requirements

Required packages to install includes (refer to pyproject.toml):

  • PyTorch
  • LangChain
  • Chroma
  • Unstructured.io
  • sentence-embedding
  • instructor-embedding

LLM Models

To quantize model, run: python -m grag.quantize.quantize

For more details, go to .\llm_quantize\readme.md Tested models:

  1. Llama-2 7B, 13B
  2. Mixtral 8x7B
  3. Gemma 7B

Model Compatibility

Refer to llama.cpp Supported Models (under Description) for list of compatible models.

Supported Vector Databases

1. Chroma

Since Chroma is a server-client based vector database, make sure to run the server.

  • To run Chroma locally, move to src/scripts then run source run_chroma.sh. This by default runs on port 8000.
  • If Chroma is not run locally, change host and port under chroma in src/config.ini.

2. Deeplake

For more information refer to Documentation.

Metadata

Release files for grag 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for grag 0.0.1
File Size Uploaded Provenance Actions
grag-0.0.1.tar.gz 28.8 MB Without provenance Details for grag-0.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for grag 0.0.1
File Interpreter ABI Platform Actions
grag-0.0.1-py3-none-any.whl Python 3 none any Details for grag-0.0.1-py3-none-any.whl

Total release size: 28.9 MB

Release files / grag-0.0.1.tar.gz

Download URL grag-0.0.1.tar.gz
Size 28.8 MB
Tags Source
SHA-256 checksum
How to use checksums
93fe46e8dcfe45c5a1e724fb52190479496245f575791cd16c13f5d9a3d966b7
BLAKE2b-256 checksum
How to use checksums
5594d425a409a24edfdef99d8243ab0ec45da080217191996de619e623d875c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-httpx/0.27.0

Release files / grag-0.0.1-py3-none-any.whl

Download URL grag-0.0.1-py3-none-any.whl
Size 56.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fe4b01a70ff05d409e284f2b39324c671d7746799ecc2f20c9b1ed34e818cf06
BLAKE2b-256 checksum
How to use checksums
0ccd58344eba5ac8c6e00eac7cab68523872ee047f3a80fd7d013d20ca72dff0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-httpx/0.27.0

Security for grag 0.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page