irace

4.4.3

Iterated Racing for Automatic Algorithm Configuration

6packages depend

70.3Kdownloads / year

72.5%test coverage

12/13checks pass

Overview

About

Maintained by Manuel López-IbáñezFirst published 2012-02-0828 releasesCRAN page ↗GitHub ↗

Iterated race is an extension of the Iterated F-race method for the automatic configuration of optimization algorithms, that is, (offline) tuning their parameters by finding the most appropriate settings given a set of instances of an optimization problem. M. López-Ibáñez, J. Dubois-Lacoste, L. Pérez Cáceres, T. Stützle, and M. Birattari (2016) doi:10.1016/j.orp.2016.09.002.

Install

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

install.packages("irace", 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("MLopez-Ibanez/irace")

Development version from MLopez-Ibanez/irace. 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-irace

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-irace

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-irace

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

Health

CRAN checks

1NOTE12OK

Failing flavors

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

Slowest check: 4.5 min · r-oldrel-macos-x86_64

Code health

Yes

Tests · ratio 0.31

72.5%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

NOTE2026-08-01
12 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
OK2026-04-25
12 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
NOTE2026-03-10
12 OK · 2 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 1,623 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 86%
Documented parameters: 96%
Return-value docs: 88%
References docs: 7%

Downloads

70.3K

CRAN downloads in the past year

Rank #1,854 · ~193/day · ~5.9K/mo

Releases R versions

Daily download trend is not available in this view yet.

2.2K30 days

13K90 days

70.3K1 year

Compare downloads with other packages →

Also on843 r2u7 autocran6K conda_forge92 c2d4u

Repository

GitHub ↗ mlopez-ibanez/irace

77Stars

18Forks

18Open issues

0Open PRs

0Releases

2,173Commits

14Contributors

roptimization-algorithmshyperparameter-tuningalgorithm-configurationiracer-package

License GPL-2.0 · 2,173 commits · Last activity 2026-07-07 · 0% stars, 30d

Stars over time

2025-02-10 · 632026-07-07 · 77

Repository practices

Upstream repositoryBeta

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

Checks run against github.com/mlopez-ibanez/irace on 2026-07-31.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (2)

MakefileDockerfile

Automation and maintenance (1)

pre-commit

Coverage (2)

Codecov.covrignore

Show all practices

Git structural (1)

Submodules

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

Dependencies

Declared dependencies

10 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.0.0

Imports (10)

R6codetoolscompilerdata.table fs matrixStats spacefillrstatsutilswithr

LinkingTo (0)

none

Suggests (5)

Rmpi highr knitrparalleltestthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

6direct

0indirect

iraceplot MOEADr ParamHelpers bbotk mlr mlr3tuning

Code & Tests

People & History

People (8)

Maintainer (1)

Manuel López-Ibáñez

Author, Maintainer

Authors (5)

Manuel López-Ibáñez

Author, Maintainer

Mauro Birattari

Author

Jérémie Dubois-Lacoste

Author

Leslie Pérez Cáceres

Author · added in 1.06

Thomas Stützle

Author

Contributors (3)

Prasanna Balaprakash

Contributor

Nguyen Dang

Contributor · added in 3.4

Eric Yuan

Contributor

Package Timeline

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

R
R 4.6.0 released · 2026-04-24
4.4.3Latest
2026-04-23 · current release · diff ↗
4.4.2
2026-04-23 · diff ↗
4.4.1
2026-03-28 · diff ↗
4.4.0
2026-02-02 · diff ↗
4.3
2025-09-11 · diff ↗
R
R 4.5.0 released · 2025-04-11
4.2.0
2025-02-12 · diff ↗
4.1
2024-12-17 · diff ↗
4.0
2024-11-27 · diff ↗
R
R 4.4.0 released · 2024-04-24
R
R 4.3.0 released · 2023-04-21
3.5
2022-10-23 · diff ↗
R
R 4.2.0 released · 2022-04-22
R
R 4.1.0 released · 2021-05-18
R
R 4.0.0 released · 2020-04-24

Show 30 earlier events

3.4.1
2020-03-31 · diff ↗
3.4
2020-03-30 · diff ↗
unarchivedReturned to CRAN
2020-03-30
archivedRemoved from CRAN
2020-03-29
check problems were not corrected in time
3.3
2019-04-27 · diff ↗
R
R 3.6.0 released · 2019-04-26
3.2
2019-04-24 · diff ↗
3.1
2018-07-12 · diff ↗
3.0
2018-07-05 · diff ↗
R
R 3.5.0 released · 2018-04-23
2.4
2017-08-03 · diff ↗
2.3
2017-04-26 · diff ↗
R
R 3.4.0 released · 2017-04-21
2.2
2017-03-24 · diff ↗
2.1
2016-10-18 · diff ↗
2.0
2016-10-08 · diff ↗
R
R 3.3.0 released · 2016-05-03
1.07
2015-09-11 · diff ↗
R
R 3.2.0 released · 2015-04-16
1.06
2014-11-26 · diff ↗
1.05
2014-07-10 · diff ↗
R
R 3.1.0 released · 2014-04-10
1.04
2013-06-09 · diff ↗
R
R 3.0.0 released · 2013-04-03
1.03
2013-01-15 · diff ↗
1.02
2012-10-12 · diff ↗
R
R 2.15.0 released · 2012-03-30
1.01
2012-03-19 · diff ↗
1.0
2012-02-08
R
R 2.14.0 released · 2011-10-31

Package metadata

First published: 2012-02-08
Total releases: 28 / 14 yrs
License: GPL (>= 2) OSI
Minimum R: ≥ 4.0.0
Download size: 1.7 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Appears in task views

Optimization and Mathematical Programming

Report a problem with this page →