ragnar

0.3.0

Retrieval-Augmented Generation (RAG) Workflows

0packages depend

12.6Kdownloads / year

40.4%test coverage

11/13checks pass

Overview

About

Maintained by Tomasz KalinowskiFirst published 2025-05-304 releasesCRAN page ↗GitHub ↗

Provides tools for implementing Retrieval-Augmented Generation (RAG) workflows with Large Language Models (LLM). Includes functions for document processing, text chunking, embedding generation, storage management, and content retrieval. Supports various document types and embedding providers ('Ollama', 'OpenAI'), with 'DuckDB' as the default storage backend. Integrates with the 'ellmer' package to equip chat objects with retrieval capabilities. Designed to offer both sensible defaults and customization options with transparent access to intermediate outputs. For a review of retrieval-augmented generation methods, see Gao et al. (2023) "Retrieval-Augmented Generation for Large Language Models: A Survey" doi:10.48550/arXiv.2312.10997.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("ragnar", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("tidyverse/ragnar")

Development version from tidyverse/ragnar. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-ragnar

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-ragnar

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-ragnar

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

2NOTE11OK

Failing flavors

NOTE r-devel-linux-x86_64-debian-clang
NOTE r-devel-linux-x86_64-debian-gcc

Slowest check: 4.3 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 0.21

40.4%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

NOTE2026-07-14
12 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-07-13
11 OK · 1 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
NOTE2026-07-11
12 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
OK2026-06-23
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-20
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE

Show 7 earlier snapshots

OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-08
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-05-24
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-05-17
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-05-15
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-05-13
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 736 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 82%
Documented parameters: 93%
Return-value docs: 82%
References docs: 0%

Downloads

12.6K

CRAN downloads in the past year

Rank #3,404 · ~35/day · ~1.1K/mo

Releases R versions

Daily download trend is not available in this view yet.

69130 days

3.5K90 days

12.6K1 year

Compare downloads with other packages →

Also on1.6K r2u29 autocran

Repository

GitHub ↗ tidyverse/ragnar

185Stars

26Forks

18Open issues

2Open PRs

4Releases

232Commits

14Contributors

232 commits · Last activity 2026-04-09 · +2.8% stars, 30d

Stars over time

2025-07-20 · 1142026-07-11 · 185

Repository practices

Upstream repositoryBeta

4 development-tooling and community-health practices detected across 4 families in the upstream repository

Checks run against github.com/tidyverse/ragnar on 2026-07-19.

Continuous integration (1)

GitHub Actions

CRAN release process (1)

cran-comments.md

Docs source (1)

README.Rmd

Lint, format, editor (1)

RStudio project

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

36 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.3.0

Imports (22)

blob cli commonmark curl DBI mirai dbplyr dplyr duckdb glue httr2 jsonlitemethodsreticulate rlang rvest S7 stringi tidyr vctrs withr xml2

LinkingTo (0)

none

Suggests (15)

connectcreds ellmer gargle knitr lifecycle mcptools pandoc paws.common rmarkdown shiny stringr testthat tibble jose openssl

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

People & History

People (3)

Maintainer (1)

Tomasz Kalinowski

Author, Maintainer

Authors (2)

Author, Maintainer

Author

Funders (1)

Package Timeline

4 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
0.3.0Latest
2026-01-23 · current release · diff ↗
0.2.1
2025-08-19 · diff ↗
0.2.0
2025-07-12 · diff ↗
unarchivedReturned to CRAN
2025-07-12
archivedRemoved from CRAN
2025-06-18
issues were not corrected in time
0.1.0
2025-05-30
R
R 4.5.0 released · 2025-04-11

Package metadata

First published: 2025-05-30
Total releases: 4 / 1 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.3.0
Download size: 2.8 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Report a problem with this page →