From adcd41eb8a6a6962a835eaeda8af0a7b4a22c263 Mon Sep 17 00:00:00 2001 From: Vishal Date: Mon, 12 Jan 2026 22:47:35 +0530 Subject: [PATCH 1/6] Docs: align README with OpenRAG documentation --- README.md | 39 +++++++-------------------------------- 1 file changed, 7 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 4e861740..8caf36c0 100644 --- a/README.md +++ b/README.md @@ -26,47 +26,22 @@ OpenRAG is a comprehensive Retrieval-Augmented Generation platform that enables ## Quickstart -To run OpenRAG without creating or modifying any project files, use `uvx`: +The recommended way to get started with OpenRAG is through the official documentation quickstart guide, which contains up-to-date installation steps, prerequisites, and usage examples: -```bash -uvx openrag -``` +👉 https://docs.openr.ag/quickstart -This command runs OpenRAG without installing it to your project or globally. - -To run a specific version of OpenRAG, run `uvx --from openrag==VERSION openrag`. +The GitHub repository focuses on the source code. Please refer to the documentation for setup and usage instructions. ## Install Python package -To add the OpenRAG Python package to a Python project, use `uv`: +OpenRAG can be installed as a Python package. For detailed installation steps, environment requirements, and environment setup guidance (e.g., managing virtual environments), see the official documentation: -1. Create a new project with a virtual environment using `uv init`: +👉 https://docs.openr.ag/install +👉 https://docs.astral.sh/uv/pip/environments - ```bash - uv init YOUR_PROJECT_NAME - cd YOUR_PROJECT_NAME - ``` +This ensures you are following the most current and supported setup. - The `(venv)` prompt doesn't change, but `uv` commands will automatically use the project's virtual environment. - For more information on virtual environments, see the [uv documentation](https://docs.astral.sh/uv/pip/environments). -2. Add OpenRAG to your project: - - ```bash - uv add openrag - ``` - - To add a specific version of OpenRAG, run `uv add openrag==VERSION`. - -3. Start the OpenRAG terminal user interface (TUI): - - ```bash - uv run openrag - ``` - -4. Continue with the [Quickstart](https://docs.openr.ag/quickstart). - -For all installation options, see the [OpenRAG installation guide](https://docs.openr.ag/install). ## Docker or Podman installation From 5d438146755a4ac00db93686fbbcb267f2adce29 Mon Sep 17 00:00:00 2001 From: April M <36110273+aimurphy@users.noreply.github.com> Date: Tue, 13 Jan 2026 05:36:53 -0800 Subject: [PATCH 2/6] temporarily add meta tag to verify algolia --- docs/docs/get-started/what-is-openrag.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/docs/get-started/what-is-openrag.mdx b/docs/docs/get-started/what-is-openrag.mdx index 440d4604..7458dccf 100644 --- a/docs/docs/get-started/what-is-openrag.mdx +++ b/docs/docs/get-started/what-is-openrag.mdx @@ -4,6 +4,8 @@ slug: / hide_table_of_contents: true --- + + OpenRAG is an open-source package for building agentic RAG systems that integrates with a wide range of orchestration tools, databases, and LLM providers. OpenRAG connects and amplifies three popular, proven open-source projects into one powerful platform: From fc299f78af8cf04e72ad92c9807e2f3494d61aae Mon Sep 17 00:00:00 2001 From: April M <36110273+aimurphy@users.noreply.github.com> Date: Tue, 13 Jan 2026 06:21:43 -0800 Subject: [PATCH 3/6] remove outdated TOC, expand develop and trbsh --- README.md | 41 +++++++++-------------------------------- 1 file changed, 9 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 8caf36c0..57159567 100644 --- a/README.md +++ b/README.md @@ -15,43 +15,20 @@ OpenRAG is a comprehensive Retrieval-Augmented Generation platform that enables Ask DeepWiki - -
- Quickstart   |   - Python package   |   - Docker or Podman   |   - Development   |   - Troubleshooting -
+## Install OpenRAG -## Quickstart +To get started with OpenRAG, see the installation guides in the OpenRAG documentation: -The recommended way to get started with OpenRAG is through the official documentation quickstart guide, which contains up-to-date installation steps, prerequisites, and usage examples: - -👉 https://docs.openr.ag/quickstart - -The GitHub repository focuses on the source code. Please refer to the documentation for setup and usage instructions. - -## Install Python package - -OpenRAG can be installed as a Python package. For detailed installation steps, environment requirements, and environment setup guidance (e.g., managing virtual environments), see the official documentation: - -👉 https://docs.openr.ag/install -👉 https://docs.astral.sh/uv/pip/environments - -This ensures you are following the most current and supported setup. - - - -## Docker or Podman installation - -By default, OpenRAG automatically starts the required containers and helps you manage them. -To install OpenRAG with self-managed containers, see the [OpenRAG installation guide](https://docs.openr.ag/docker). +* [Quickstart](https://docs.openr.ag/quickstart) +* [Install the OpenRAG Python package](https://docs.openr.ag/install-options) +* [Deploy self-managed services with Docker or Podman](https://docs.openr.ag/docker) ## Development -For developers wanting to contribute to OpenRAG or set up a development environment, see [CONTRIBUTING.md](CONTRIBUTING.md). +For developers who want to [contribute to OpenRAG](https://docs.openr.ag/support/contribute) or set up a development environment, see [CONTRIBUTING.md](CONTRIBUTING.md). ## Troubleshooting -For common issues and fixes, see [Troubleshoot OpenRAG](https://docs.openr.ag/support/troubleshoot). \ No newline at end of file +For assistance with OpenRAG, see [Troubleshoot OpenRAG](https://docs.openr.ag/support/troubleshoot) and visit the [Discussions page](https://github.com/langflow-ai/openrag/discussions). + +To report a bug or submit a feature request, visit the [Issues page](https://github.com/langflow-ai/openrag/issues). \ No newline at end of file From a454167a4daf64fb7a9aa2c56a946d0d3e2cc6a8 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Tue, 13 Jan 2026 09:51:14 -0500 Subject: [PATCH 4/6] global-head-meta --- docs/docs/get-started/what-is-openrag.mdx | 2 -- docs/docusaurus.config.js | 8 ++++++++ 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/docs/get-started/what-is-openrag.mdx b/docs/docs/get-started/what-is-openrag.mdx index 7458dccf..440d4604 100644 --- a/docs/docs/get-started/what-is-openrag.mdx +++ b/docs/docs/get-started/what-is-openrag.mdx @@ -4,8 +4,6 @@ slug: / hide_table_of_contents: true --- - - OpenRAG is an open-source package for building agentic RAG systems that integrates with a wide range of orchestration tools, databases, and LLM providers. OpenRAG connects and amplifies three popular, proven open-source projects into one powerful platform: diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index 05232b40..61dd67ff 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -17,6 +17,14 @@ const config = { favicon: 'img/favicon.ico', headTags: [ + // Algolia site verification meta tag + { + tagName: "meta", + attributes: { + name: "algolia-site-verification", + content: "424339D27FB7921F", + }, + }, ...(isProduction ? [ // Google Consent Mode - Set defaults before Google tags load From a6692aa3e140921b52a96dcfea80b9d176608320 Mon Sep 17 00:00:00 2001 From: April M <36110273+aimurphy@users.noreply.github.com> Date: Tue, 13 Jan 2026 07:49:45 -0800 Subject: [PATCH 5/6] generate sitemap --- docs/docusaurus.config.js | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index 61dd67ff..d708ca59 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -184,6 +184,19 @@ const config = { theme: { customCss: './src/css/custom.css', }, + // Use preset-classic sitemap https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-sitemap + sitemap: { + lastmod: 'date', + changefreq: 'weekly', + priority: 0.5, + ignorePatterns: ['/tags/**'], + filename: 'sitemap.xml', + createSitemapItems: async (params) => { + const {defaultCreateSitemapItems, ...rest} = params; + const items = await defaultCreateSitemapItems(rest); + return items.filter((item) => !item.url.includes('/page/')); + }, + }, }), ], ], From 346ad126dee5a95324b3174c62fbdafe30bbbee9 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Tue, 13 Jan 2026 11:05:32 -0500 Subject: [PATCH 6/6] allow-indexing-to-generate-sitemap --- docs/docusaurus.config.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index d708ca59..71f7e272 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -135,7 +135,7 @@ const config = { baseUrl: process.env.BASE_URL ? process.env.BASE_URL : '/', // Control search engine indexing - set to true to prevent indexing - noIndex: true, + noIndex: false, // GitHub pages deployment config. // If you aren't using GitHub pages, you don't need these.