Skip to content
The official RISC-V getting started guide
Branch: master
Clone or download
Latest commit c09298f May 31, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
source Remove unwanted space May 31, 2019
.gitignore Initial commit. Nov 1, 2018
Makefile Put variable in quotes Nov 15, 2018
README.rst Reorganization of ordering in Guide + minor updates May 5, 2019 Initial commit. Nov 1, 2018
requirements.txt Add new req for non-selectable prompt Nov 30, 2018


RISC-V Getting Started Guide

This is the repository for the RISC-V Getting Started Guide, an introductory material prepared by the RISC-V Foundation and hosted at Read The Docs to show you where to start if you're interested in developing for the free and open source ISA.

For details about RISC-V itself, see the RISC-V Website.

You can contribute to the Getting Started Guide too! We are always happy to add more platforms and examples, and make the Guide more attractive to readers. See Contributing below for details.

Compiling the Guide

The Guide is built using Sphinx, a popular documentation framework used e.g. by Python, Zephyr and Linux, based on reStructuredText.

Sphinx can be installed with pip, the Python package manager:

pip install sphinx

(for detailed instructions, see Installing Sphinx)

To compile the HTML version of the Guide, use:

make html

The output will reside in the build/ directory.

You can also generate a PDF, which requires TeX and a few other tools.


The RISC-V ecosystem is largely based around a diversified pool of corporate and personal contributions coming from over 130 corporate members and thousands of developers around the world. We especially welcome contributions that make RISC-V more accessible to the broader public (such as improving this Guide) - and we are happy you are reading this!

Please use the GitHub issues and pull requests mechanisms to contribute to the Guide. This may include:

  • guides for new platforms (please follow the style in which existing platforms are written)
  • corrections and extensions to existing platforms
  • more advanced pieces of content showcasing additional software that can be run on RISC-V

Note that in order to keep the material universally accessible, please only contribute guides based on software that is freely available without unnecessary limitation.

New platform contributions should be complete and tested on multiple platforms (or at least explicitly marked as incomplete in some aspects), so that users can get started successfully without running into problems.

For the sake of clarity, legibility and user-friendliness, the RISC-V Foundation reserves the right to modify or refuse to include submitted pieces of content at its discretion.

You can’t perform that action at this time.