<div align="center">
<h1>Ragbits</h1>
*Building blocks for rapid development of GenAI applications*
[Documentation](https://ragbits.deepsense.ai) | [Contact](https://deepsense.ai/contact/)
[](https://pypi.org/project/ragbits)
[](https://pypi.org/project/ragbits)
[](https://pypi.org/project/ragbits)
</div>
---
## What's Included?
- [X] **[Core](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-core)** - Fundamental tools for working with prompts and LLMs.
- [X] **[Document Search](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-document-search)** - Handles vector search to retrieve relevant documents.
- [X] **[CLI](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-cli)** - The `ragbits` shell command, enabling tools such as GUI prompt management.
- [x] **[Guardrails](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-guardrails)** - Ensures response safety and relevance.
- [x] **[Evaluation](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-evaluate)** - Unified evaluation framework for Ragbits components.
- [ ] **Flow Controls** - Manages multi-stage chat flows for performing advanced actions *(coming soon)*.
- [ ] **Structured Querying** - Queries structured data sources in a predictable manner *(coming soon)*.
- [ ] **Caching** - Adds a caching layer to reduce costs and response times *(coming soon)*.
## Installation
To use the complete Ragbits stack, install the `ragbits` package:
```sh
pip install ragbits
```
Alternatively, you can use individual components of the stack by installing their respective packages: `ragbits-core`, `ragbits-document-search`, `ragbits-cli`.
## Quickstart
First, create a prompt and a model for the data used in the prompt:
```python
from pydantic import BaseModel
from ragbits.core.prompt import Prompt
class Dog(BaseModel):
breed: str
age: int
temperament: str
class DogNamePrompt(Prompt[Dog, str]):
system_prompt = """
You are a dog name generator. You come up with funny names for dogs given the dog details.
"""
user_prompt = """
The dog is a {breed} breed, {age} years old, and has a {temperament} temperament.
"""
```
Next, create an instance of the LLM and the prompt:
```python
from ragbits.core.llms.litellm import LiteLLM
llm = LiteLLM("gpt-4o")
example_dog = Dog(breed="Golden Retriever", age=3, temperament="friendly")
prompt = DogNamePrompt(example_dog)
```
Finally, generate a response from the LLM using the prompt:
```python
response = await llm.generate(prompt)
print(f"Generated dog name: {response}")
```
<!--
TODO:
Add links to quickstart guides for individual packages, demonstrating how to extend this with their functionality.
Add a link to the full tutorial.
-->
## License
Ragbits is licensed under the [MIT License](https://github.com/deepsense-ai/ragbits/tree/main/LICENSE).
## Contributing
We welcome contributions! Please read [CONTRIBUTING.md](https://github.com/deepsense-ai/ragbits/tree/main/CONTRIBUTING.md) for more information.
Raw data
{
"_id": null,
"home_page": null,
"name": "ragbits",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "GenAI, Generative AI, LLMs, Large Language Models, Prompt Management, RAG, Retrieval Augmented Generation",
"author": null,
"author_email": "\"deepsense.ai\" <ragbits@deepsense.ai>",
"download_url": "https://files.pythonhosted.org/packages/af/8f/322da846b763138e26c0b18d639afcd40c7fa32b0fe8a4666944de4d3e91/ragbits-0.7.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n<h1>Ragbits</h1>\n\n*Building blocks for rapid development of GenAI applications*\n\n[Documentation](https://ragbits.deepsense.ai) | [Contact](https://deepsense.ai/contact/)\n\n[](https://pypi.org/project/ragbits)\n[](https://pypi.org/project/ragbits)\n[](https://pypi.org/project/ragbits)\n\n</div>\n\n---\n\n## What's Included?\n\n- [X] **[Core](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-core)** - Fundamental tools for working with prompts and LLMs.\n- [X] **[Document Search](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-document-search)** - Handles vector search to retrieve relevant documents.\n- [X] **[CLI](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-cli)** - The `ragbits` shell command, enabling tools such as GUI prompt management.\n- [x] **[Guardrails](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-guardrails)** - Ensures response safety and relevance.\n- [x] **[Evaluation](https://github.com/deepsense-ai/ragbits/tree/main/packages/ragbits-evaluate)** - Unified evaluation framework for Ragbits components.\n- [ ] **Flow Controls** - Manages multi-stage chat flows for performing advanced actions *(coming soon)*.\n- [ ] **Structured Querying** - Queries structured data sources in a predictable manner *(coming soon)*.\n- [ ] **Caching** - Adds a caching layer to reduce costs and response times *(coming soon)*.\n\n## Installation\n\nTo use the complete Ragbits stack, install the `ragbits` package:\n\n```sh\npip install ragbits\n```\n\nAlternatively, you can use individual components of the stack by installing their respective packages: `ragbits-core`, `ragbits-document-search`, `ragbits-cli`.\n\n## Quickstart\n\nFirst, create a prompt and a model for the data used in the prompt:\n\n```python\nfrom pydantic import BaseModel\nfrom ragbits.core.prompt import Prompt\n\nclass Dog(BaseModel):\n breed: str\n age: int\n temperament: str\n\nclass DogNamePrompt(Prompt[Dog, str]):\n system_prompt = \"\"\"\n You are a dog name generator. You come up with funny names for dogs given the dog details.\n \"\"\"\n\n user_prompt = \"\"\"\n The dog is a {breed} breed, {age} years old, and has a {temperament} temperament.\n \"\"\"\n```\n\nNext, create an instance of the LLM and the prompt:\n\n```python\nfrom ragbits.core.llms.litellm import LiteLLM\n\nllm = LiteLLM(\"gpt-4o\")\nexample_dog = Dog(breed=\"Golden Retriever\", age=3, temperament=\"friendly\")\nprompt = DogNamePrompt(example_dog)\n```\n\nFinally, generate a response from the LLM using the prompt:\n\n```python\nresponse = await llm.generate(prompt)\nprint(f\"Generated dog name: {response}\")\n```\n\n<!--\nTODO:\nAdd links to quickstart guides for individual packages, demonstrating how to extend this with their functionality.\nAdd a link to the full tutorial.\n-->\n\n## License\n\nRagbits is licensed under the [MIT License](https://github.com/deepsense-ai/ragbits/tree/main/LICENSE).\n\n## Contributing\n\nWe welcome contributions! Please read [CONTRIBUTING.md](https://github.com/deepsense-ai/ragbits/tree/main/CONTRIBUTING.md) for more information.\n",
"bugtrack_url": null,
"license": null,
"summary": "Building blocks for rapid development of GenAI applications",
"version": "0.7.0",
"project_urls": {
"Bug Reports": "https://github.com/deepsense-ai/ragbits/issues",
"Documentation": "https://ragbits.deepsense.ai/",
"Homepage": "https://github.com/deepsense-ai/ragbits",
"Source": "https://github.com/deepsense-ai/ragbits"
},
"split_keywords": [
"genai",
" generative ai",
" llms",
" large language models",
" prompt management",
" rag",
" retrieval augmented generation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "75dfa511cc5ea90361bbaf7e333d7898148a857082e3f0a96e5cd4b62f53259d",
"md5": "1e070cf8177d141913847ad5eb5b2cb0",
"sha256": "e8cdb6be6f5445f26d3f88433d16c45201a4e18fef96bffd50d72f450bc9e6a4"
},
"downloads": -1,
"filename": "ragbits-0.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1e070cf8177d141913847ad5eb5b2cb0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 2832,
"upload_time": "2025-01-21T15:59:43",
"upload_time_iso_8601": "2025-01-21T15:59:43.540690Z",
"url": "https://files.pythonhosted.org/packages/75/df/a511cc5ea90361bbaf7e333d7898148a857082e3f0a96e5cd4b62f53259d/ragbits-0.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "af8f322da846b763138e26c0b18d639afcd40c7fa32b0fe8a4666944de4d3e91",
"md5": "f252adddcd9efc1822b5b8e5ea082808",
"sha256": "3a08fb2649c1122966bb5f9c13f252c7e6e8ee87be11988252ca11e75a735e68"
},
"downloads": -1,
"filename": "ragbits-0.7.0.tar.gz",
"has_sig": false,
"md5_digest": "f252adddcd9efc1822b5b8e5ea082808",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 5267,
"upload_time": "2025-01-21T15:59:54",
"upload_time_iso_8601": "2025-01-21T15:59:54.949543Z",
"url": "https://files.pythonhosted.org/packages/af/8f/322da846b763138e26c0b18d639afcd40c7fa32b0fe8a4666944de4d3e91/ragbits-0.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-21 15:59:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "deepsense-ai",
"github_project": "ragbits",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ragbits"
}
JSON
