{"id":46008,"library":"r2r","title":"R2R (SciPhi)","description":"R2R is a production-ready Retrieval-Augmented Generation (RAG) engine by SciPhi. It provides a scalable pipeline for document ingestion, chunking, embedding, and generation with support for various LLMs and vector stores. Current version 3.6.6 (PyPI), with active development and frequent releases.","status":"active","version":"3.6.6","language":"python","source_language":"en","source_url":"https://github.com/SciPhi-AI/R2R","tags":["rag","retrieval-augmented-generation","llm","pipeline","document-ingestion"],"install":[{"cmd":"pip install r2r","lang":"bash","label":"PyPI install"}],"dependencies":[{"reason":"Extra install for all optional dependencies (e.g., vector stores, LLM providers)","package":"r2r[all]","optional":true}],"imports":[{"note":"Primary client class for interacting with the R2R server.","symbol":"R2RClient","correct":"from r2r import R2RClient"},{"note":"Configuration class for R2R pipeline.","symbol":"R2RConfig","correct":"from r2r import R2RConfig"},{"note":"Exception class for R2R errors.","symbol":"R2RException","correct":"from r2r import R2RException"}],"quickstart":{"code":"import os\nfrom r2r import R2RClient\n\nclient = R2RClient(base_url=os.environ.get('R2R_BASE_URL', 'http://localhost:7272'))\n# Example: ingest a document\nresponse = client.ingest_files(['./README.md'])\nprint(response)","lang":"python","description":"Initialize R2R client and ingest a file. Requires a running R2R server."},"warnings":[{"fix":"Migrate to the new client and configuration patterns. See https://r2r-docs.sciphi.ai/migration-guide","message":"Version 3.x introduced significant API changes. The client API, configuration, and pipeline structure were redesigned. Code written for r2r<3.0.0 will not work with 3.6.6.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Always set R2R_BASE_URL environment variable or pass base_url explicitly.","message":"The default base_url is http://localhost:7272. If not set, the client will try to connect to localhost, which may fail if the server is running elsewhere.","severity":"gotcha","affected_versions":">=3.0.0"},{"fix":"Ensure your Python version is 3.10-3.12.","message":"R2R requires Python >=3.10 and <3.13. Python 3.13 is not supported.","severity":"gotcha","affected_versions":"3.6.6"},{"fix":"Use ingest_files for new documents and update_files for updates.","message":"Some older ingestion methods (e.g., add_entry) are deprecated in favor of ingest_files and update_files.","severity":"deprecated","affected_versions":">=3.0.0"}],"env_vars":null,"search_vec":"'3.6.6':39 'activ':42 'augment':11,50 'chunk':25 'current':37 'develop':43 'document':23,55 'document-ingest':54 'embed':26 'engin':14 'frequent':45 'generat':12,28,51 'ingest':24,56 'llm':52 'llms':33 'pipelin':21,53 'product':7 'production-readi':6 'provid':18 'pypi':40 'r2r':1,3 'rag':13,47 'readi':8 'releas':46 'retriev':10,49 'retrieval-aug':9 'retrieval-augmented-gener':48 'scalabl':20 'sciphi':2,16 'store':36 'support':30 'various':32 'vector':35 'version':38","created_at":"2026-06-07T12:57:50.286304+00:00","updated_at":"2026-06-07T12:57:50.286304+00:00","problems":[{"fix":"Ensure you have installed r2r>=3.0.0 and use 'from r2r import R2RClient'.","cause":"Version mismatch or incorrect import path. In older versions (<3.0), R2RClient was located differently.","error":"ImportError: cannot import name 'R2RClient' from 'r2r'"},{"fix":"Start the R2R server (e.g., r2r serve) or check the R2R_BASE_URL environment variable.","cause":"The R2R server is not running or the base_url is incorrect.","error":"r2r.exceptions.R2RException: Server error: 404 Not Found"},{"fix":"Downgrade to Python 3.10, 3.11, or 3.12.","cause":"R2R requires Python <3.13.","error":"RuntimeError: Python 3.13+ is not supported"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml","search"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}