Need help with risc-v-getting-started-guide?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

136 Stars 31 Forks 117 Commits 16 Opened issues


The official RISC-V getting started guide

Services available


Need anything else?

Contributors list

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

_ 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

, 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


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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.