ragup 0.1.0__py3-none-any.whl

ragup/vectordb/manager.py

@@ -0,0 +1,51 @@
+"""
+Vector database manager.
+"""
+
+from __future__ import annotations
+
+from .chroma import ChromaVectorDB
+
+
+class VectorDBManager:
+    """
+    High-level interface for the vector database.
+    """
+
+    def __init__(self):
+
+        self.db = ChromaVectorDB()
+
+    def add(
+        self,
+        ids: list[str],
+        documents: list[str],
+        embeddings: list[list[float]],
+        metadatas: list[dict],
+    ) -> None:
+
+        self.db.add(
+            ids=ids,
+            documents=documents,
+            embeddings=embeddings,
+            metadatas=metadatas,
+        )
+
+    def search(
+        self,
+        embedding: list[float],
+        top_k: int = 5,
+    ) -> dict:
+
+        return self.db.search(
+            embedding,
+            top_k,
+        )
+
+    def count(self) -> int:
+
+        return self.db.count()
+
+    def reset(self) -> None:
+
+        self.db.reset()

ragup-0.1.0.dist-info/METADATA

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: ragup
+Version: 0.1.0
+Summary: Build semantic search, question answering, and FastAPI-powered RAG applications in just a few lines of Python.
+Author-email: Mehul Dewan <mehul.work.17@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/mehuldewan17/RagUp
+Project-URL: Repository, https://github.com/mehuldewan17/RagUp
+Project-URL: Issues, https://github.com/mehuldewan17/RagUp/issues
+Keywords: rag,genai,llm,embeddings,semantic-search,vector-database,chromadb,fastapi,ai,python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pymupdf>=1.24.0
+Requires-Dist: chromadb>=0.5.0
+Requires-Dist: sentence-transformers>=3.0.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: litellm>=1.40.0
+Requires-Dist: pydantic>=2.8.0
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: tqdm>=4.66.0
+Requires-Dist: typing_extensions>=4.12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: isort>=5.13.0; extra == "dev"
+Requires-Dist: mypy>=1.10.0; extra == "dev"
+Dynamic: license-file
+
+# 🚀 RagUp
+
+> Build semantic search, AI-powered question answering, and FastAPI APIs from your documents in just a few lines of Python.
+
+RagUp is an opinionated Python library that lets you turn documents into searchable AI knowledge bases with almost no setup.
+
+---
+
+## ✨ Features
+
+- 📄 Supports PDF, TXT and JSON documents
+- 🧠 Local embeddings using Sentence Transformers
+- 🔍 Semantic Search
+- 🤖 AI-powered Question Answering (Gemini)
+- ⚡ FastAPI server with automatic Swagger UI
+- 💾 Persistent indexing (no re-indexing if nothing changes)
+- 🐍 Simple Python API
+
+---
+
+## 📦 Installation
+
+```bash
+pip install ragup
+```
+
+---
+
+## ⚡ Quick Start
+
+```python
+from ragup import Document
+
+doc = Document("policy.pdf")
+
+# Build the index
+doc.ragup()
+
+# Semantic Search
+results = doc.search(
+    "refund policy"
+)
+
+print(results)
+
+# AI Question Answering
+answer = doc.ask(
+    "What is the refund policy?",
+    api_key="YOUR_GEMINI_API_KEY"
+)
+
+print(answer)
+
+# Launch FastAPI
+doc.serve(
+    api_key="YOUR_GEMINI_API_KEY"
+)
+```
+
+Open
+
+```
+http://localhost:8085/docs
+```
+
+to access the interactive Swagger UI.
+
+---
+
+# 📚 Supported Documents
+
+| Format | Supported |
+|---------|-----------|
+| PDF | ✅ |
+| TXT | ✅ |
+| JSON | ✅ |
+
+---
+
+# 🔍 Semantic Search
+
+```python
+results = doc.search(
+    "shipping charges",
+    top_k=3
+)
+```
+
+Returns the most relevant chunks from your document.
+
+---
+
+# 🤖 AI Question Answering
+
+```python
+answer = doc.ask(
+    "Summarize this document",
+    api_key="YOUR_GEMINI_API_KEY"
+)
+```
+
+RagUp retrieves relevant chunks and asks Gemini to answer using only the document context.
+
+---
+
+# 🌐 FastAPI Server
+
+```python
+doc.serve(
+    api_key="YOUR_GEMINI_API_KEY"
+)
+```
+
+Available endpoints
+
+```
+POST /search
+POST /ask
+GET  /health
+GET  /docs
+```
+
+If no API key is supplied,
+
+```python
+doc.serve()
+```
+
+the `/ask` endpoint is automatically disabled.
+
+---
+
+# 💾 Persistent Indexing
+
+The first time you call
+
+```python
+doc.ragup()
+```
+
+RagUp creates a local index.
+
+Subsequent calls reuse the cached index automatically if the document hasn't changed, making startup almost instantaneous.
+
+---
+
+# 🛣 Roadmap
+
+### v0.1.0
+
+- ✅ PDF Support
+- ✅ TXT Support
+- ✅ JSON Support
+- ✅ Semantic Search
+- ✅ Gemini Question Answering
+- ✅ FastAPI Server
+- ✅ Persistent Indexing
+
+### Upcoming
+
+- DOCX Support
+- Markdown Support
+- HTML Support
+- Multi-document collections
+- Multiple LLM providers
+- Better chunking strategies
+- CLI Support
+
+---
+
+# 🤝 Contributing
+
+Contributions, feature requests and bug reports are welcome.
+
+Feel free to open an issue or submit a pull request.
+
+---
+
+# 📄 License
+
+MIT License
+
+---
+
+🧠 Built by the brain of **Mehul Dewan**. Powered by caffeine.

ragup-0.1.0.dist-info/RECORD

@@ -0,0 +1,39 @@
+ragup/__init__.py,sha256=nBoz1q8tmIVkqtqw_sFnC3D4rz_UN8asfvgyhnFqDKM,95
+ragup/config.py,sha256=EDa0RyhlbcMU785cOuPC-QJ8FxsGqJg45gT55f5TiOk,1027
+ragup/constants.py,sha256=H2LqakDvJCf_iwxGutFNvdJPGsP7FhezSojz1b-Tx4E,1596
+ragup/exceptions.py,sha256=DpyFgSbneI6Jy0r2t_xlv1VfcPiYWzE5KBVO9uGXDe0,1012
+ragup/api/__init__.py,sha256=nOSjAcDcruQfp3kVTRiUOcAi5pEzJWPIhH_dcgboZX0,69
+ragup/api/routes.py,sha256=1NZLmvbXxWvRojNj8PKDj-TD9qE1wufWDnKVizNq9nE,82
+ragup/api/schemas.py,sha256=A2g93rZ3ViesFkTdyVUn_NqTAuP8DLkiwIzHQEM3lRo,214
+ragup/api/server.py,sha256=eelq-nKVyIPaUV1_46qrXXEOH-wIP8yytkl27VIewsQ,1582
+ragup/chunking/__init__.py,sha256=2jOrifoGAzBULxu_hciCfkSm6MilXY1CBSjNBeWlCp0,137
+ragup/chunking/base.py,sha256=Xnltm1LtyqfNWbV9Q6r7OF7jtCEN4x5A2gnF3jmmtMY,670
+ragup/chunking/recursive.py,sha256=FNOhx-T2b_YL7VAfM69KkKoS6et5bqgFqHDBlPucISQ,1175
+ragup/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ragup/core/document.py,sha256=8hRG5kmcTZJhBaHUky6642Mjwg4abVhSFXpFijB-tw8,6295
+ragup/embeddings/__init__.py,sha256=9PPb3OfLw8mf6j42oEh2HYA0lVtTM9qrFCowFVp-45M,96
+ragup/embeddings/embedder.py,sha256=i1EDamvsD1wJbf9uU_5vcVT_VorfRUWaQqMVx-d3Ba0,1241
+ragup/embeddings/models.py,sha256=DKY1GrNB8DBCPyUah6nSuE2tGcqD-FUdXPOg_SEAo6U,510
+ragup/llm/__init__.py,sha256=MJOsNwWUpkMQVTWQvplZLYD5nX1vMsL0ER3Xf_FIv84,102
+ragup/llm/answer.py,sha256=9cv7TFcVEpWu69MpFwZSJYrE_ZBuMuCHmnT9-UbNki0,1096
+ragup/llm/prompt.py,sha256=6XksQLXkz2lUDcixKJpKoNm3QycJzFoq8QjY-DKfUxU,601
+ragup/loaders/__init__.py,sha256=-DFEqDRlEFg_gpfHkFXY4as2M99PC0KIF6Xyty5UM0A,1133
+ragup/loaders/base.py,sha256=ENKiBj6a51TDtP0oKDe-kQK-Vj2vNVblpj5LNsf_oqU,649
+ragup/loaders/json_loader.py,sha256=q8zsm842tOjaKZiXdI2CM7bYKHORKeZBPOTOCTIqVx0,968
+ragup/loaders/pdf_loader.py,sha256=pIAx4KmerlAS0AiatZOVEVA4H60myQnDYFF9jA9gHUo,841
+ragup/loaders/txt_loader.py,sha256=-j12iVNVzzvmcLEu9wGq-2HeLW01fdHGJiHdtH445oI,1023
+ragup/retrieval/__init__.py,sha256=BTiFFO3gUW5GmEJ7pG0LLoFUeC9DnHVDTv1IYqCTbyQ,172
+ragup/retrieval/retriever.py,sha256=88hZ_6duJBzDZ441uoPA6UAGKJptQ90biE3y-tn477w,777
+ragup/retrieval/search.py,sha256=EKoa52H2QfExXwvfiGOt_6PJbee7nP56l45rDrUh9kw,1175
+ragup/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ragup/utils/helpers.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ragup/utils/logger.py,sha256=cTZFgtjxjCzvblSbC0RMtLmfT2lY0dQeV4ZqZ7Gsn5c,806
+ragup/utils/validators.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ragup/vectordb/__init__.py,sha256=nUVGsjSXoWlOabwRRLYXDD82CUmpxawNDGSz_sMMjd4,115
+ragup/vectordb/chroma.py,sha256=oZbZIhM2ubXA43Pb8cpXPKvSYahrPfdpkg22C5BSXP0,2214
+ragup/vectordb/manager.py,sha256=E9az_8bnach3_Sgu1R5mUepgEEQ6kwolA0c2FX8vY80,929
+ragup-0.1.0.dist-info/licenses/LICENSE,sha256=3YOjD-Mi681Le2UzX0rqyOuQPRlxAsDmdoTSeJ4apqg,1087
+ragup-0.1.0.dist-info/METADATA,sha256=Dm9wk8fHHBJIrlUpzY2K9khqhVefBgnGwNVK_XT42o0,4590
+ragup-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+ragup-0.1.0.dist-info/top_level.txt,sha256=VABr0T6Jg-TCX85RHFPaZtuswPRX42YkShbt0uSXMvo,6
+ragup-0.1.0.dist-info/RECORD,,

ragup-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ragup-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mehul Dewan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ragup-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ragup