{"library":"ragie","title":"RAGIE Python Client SDK","description":"The `ragie` Python Client SDK, currently at version 1.15.1, provides an idiomatic interface to access the Ragie API for Retrieval-Augmented Generation (RAG) applications. It enables developers to integrate Ragie's RAG capabilities, including document ingestion, chunk retrieval, and interaction with LLMs. The library appears to have a regular release cadence with frequent updates and new features.","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install ragie"],"cli":null},"imports":["from ragie import Ragie"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom ragie import Ragie\nfrom dotenv import load_dotenv\n\nload_dotenv() # Load environment variables from .env file\n\nRAGIE_API_KEY = os.environ.get(\"RAGIE_API_KEY\", \"\")\n\nif not RAGIE_API_KEY:\n    raise ValueError(\"RAGIE_API_KEY environment variable not set. Get one at https://secure.ragie.ai/api-keys\")\n\ntry:\n    # Initialize the Ragie client using a context manager for resource cleanup\n    with Ragie(auth=RAGIE_API_KEY) as ragie_client:\n        # Create a raw document\n        print(\"Creating a raw document...\")\n        document = ragie_client.documents.create_raw(request={\n            \"data\": \"The quick brown fox jumps over the lazy dog. A common phrase used to test typewriters.\"\n        })\n        print(f\"Document created with ID: {document.id}\")\n\n        # Wait for the document to be ready (simplified polling for demonstration)\n        print(\"Waiting for document to be ready...\")\n        while True:\n            doc_status = ragie_client.documents.get(document_id=document.id)\n            if doc_status.status == \"ready\":\n                print(f\"Document {document.id} is ready.\")\n                break\n            # In a real application, you'd add a delay (e.g., time.sleep(1)) and/or timeout\n\n        # Retrieve chunks based on a query\n        print(\"Retrieving chunks...\")\n        retrieval = ragie_client.retrievals.retrieve(request={\"query\": \"What is a common phrase?\"})\n        if retrieval.chunks:\n            for chunk in retrieval.chunks:\n                print(f\"Retrieved chunk: {chunk.text}\")\n        else:\n            print(\"No chunks retrieved for the query.\")\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")\n    # Consider handling specific ragie.models.RagieError for API-related issues","lang":"python","description":"This quickstart demonstrates how to initialize the Ragie client, create a raw text document, wait for its processing to complete (indicated by the 'ready' status), and then perform a retrieval query to get relevant information based on the ingested document. Ensure you have `RAGIE_API_KEY` set as an environment variable.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"1.15.1","pypi_latest":"1.15.1","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":3.9,"avg_import_s":1.41,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.3,"mem_mb":18.1,"disk_size":"34.5M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":4.4,"import_time_s":0.92,"mem_mb":18.1,"disk_size":"34M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.74,"mem_mb":19.3,"disk_size":"37.8M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.7,"import_time_s":1.53,"mem_mb":19.3,"disk_size":"37M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.63,"mem_mb":19.1,"disk_size":"29.3M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.2,"import_time_s":1.61,"mem_mb":19.1,"disk_size":"29M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.59,"mem_mb":19.9,"disk_size":"29.1M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.3,"import_time_s":1.52,"mem_mb":19.9,"disk_size":"29M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.23,"mem_mb":18,"disk_size":"33.9M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"ragie","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":5,"import_time_s":1.07,"mem_mb":18,"disk_size":"33M"}]}}