🌀 Learn R, in R.
Latest commit d85769b Jun 23, 2016 @seankross seankross committed on GitHub Merge pull request #497 from swirldev/dev
Update to 2.4.2
Failed to load latest commit information.
R fixed #434 Jun 22, 2016
inst use stringi in encoding test Mar 16, 2016
man added testthat_legacy Apr 11, 2016
revdep fixed #434 Jun 22, 2016
tests fixed expectation issue Apr 8, 2016
.Rbuildignore added revdep Apr 14, 2016
.gitignore add ?InstallCourses Jul 29, 2014
.travis.yml added logging Feb 18, 2016
DESCRIPTION fixed #434 Jun 22, 2016
LICENSE fixed install_course bug Feb 24, 2016
NAMESPACE fixed #434 Jun 22, 2016
NEWS.md fixed #434 Jun 22, 2016
README.md updated README Jun 22, 2016
cran-comments.md fixed #434 Jun 22, 2016
swirl.Rproj add ?InstallCourses Jul 29, 2014



Build Status CRAN version Downloads


swirl is a platform for learning (and teaching) statistics and R simultaneously and interactively. It presents a choice of course lessons and interactively tutors a student through them. A student may be asked to watch a video, to answer a multiple-choice or fill-in-the-blanks question, or to enter a command in the R console precisely as if he or she were using R in practice. Emphasis is on the last, interacting with the R console. User responses are tested for correctness and hints are given if appropriate. Progress is automatically saved so that a user may quit at any time and later resume without losing work.

swirl leans heavily on exercising a student's use of the R console. A callback mechanism, suggested and first demonstrated for the purpose by Hadley Wickham, is used to capture student input and to provide immediate feedback relevant to the course material at hand.

swirlify is a separate R package that provides a comprehensive toolbox for swirl instructors. Content is authored in YAML using the handy tools described on the instructors page of our website.

The program is initiated with swirl(). Functions which control swirl's behavior include bye() to quit, skip() to skip a question, main() to return to the main menu, play() to allow experimentation in the R console without interference from swirl, nxt() to resume interacting with swirl, and info() to display a help menu.

Installing swirl (from CRAN)

The easiest way to install and run swirl is by typing the following from the R console:


As we continue adding new features and content, we will make new versions available on CRAN as appropriate (every 1-2 months, most likely).

Installing the latest development version (from GitHub)

To access the most recent features and content, you can install and run the development version of swirl using the devtools package:

devtools::install_github("swirldev/swirl", ref = "dev")

Contributing to swirl's development

If you'd like to get involved, please fork this repository and submit a pull request with your proposed changes. We're happy to chat if you have any questions about the source code.

Using swirl in the classroom

Instructors around the world are using swirl in their classrooms. We think this is awesome. If you're an instructor, please feel free to do the same -- free of charge. While your students may be paying to take your course or attend your institution, we simply ask that you don't charge people directly for the use of our software or instructional content.

If you are not sure about a particular use case, don't hesitate to send us an email at info@swirlstats.com.