Skip to content
A Rakudo distribution builder based on Dist::Zilla
Latest commit 4a7b4a8 Feb 3, 2012 @perlpilot updates
Failed to load latest commit information.
docs Added parrot project; remove lib Jul 31, 2010


This is Rakudo Star, a useful, usable Perl 6 distribution for "early adopters".

This is the {{ $dist->version }} release of Rakudo Star.

Rakudo Star is Copyright (C) 2010-2012 by the Rakudo Star Team.

License Information
Rakudo Star is distributed under the terms of the Artistic License 2.0.
This distribution contains software collected from other sources; see the
individual source subdirectories (in parrot/, rakudo/, and modules/) for
copyright and licensing information of those components.

Build Prerequisites
To build Rakudo Star you need at least a C compiler, a 'make' utility,
and Perl 5.8.4 or newer.  You probably also want a machine with a fair
amount of memory available: 256MB is known to be too small for building 
Rakudo, while 1GB is generally known to be sufficient.

In order to fully support Unicode, you'll also want to have the
ICU library installed (
Rakudo can run without ICU, but some Unicode-related features
will not work properly.

On Debian GNU/Linux or Ubuntu Linux, the necessary components
for building Rakudo can be installed via the command

    aptitude install build-essential libicu-dev subversion

Readline support also requires the "libreadline5-dev" library.

On RedHat/Fedora/CentOS, the components can be installed with

    yum groupinstall development-tools
    yum install libicu-devel subversion readline-devel

Rakudo Star includes Blizkost, which enables you to use Perl 5
modules from Perl 6. If you wish to use this, then you must have
the Perl 5 development libraries available for either Perl 5.10 or
Perl 5.12; on Debian/Ubuntu this is available through the libperl-dev

Building Rakudo Star
The basic steps to build Rakudo Star are:

    $ perl --gen-parrot
    $ make
    $ make install

This will build a Perl 6 executable and install selected
Perl 6 modules in the install/ subdirectory.  Programs can
then be run directly using a command like:

    $ ./perl6

Programs can also be run by adding the "install/bin" directory
to your PATH environment variable.

The "--gen-parrot" option above tells to automatically
build and install the version of Parrot that is distributed with 
Rakudo Star.  The "--prefix=" option can be provided to
to change the location of the install directory.

If your system already has an installed Parrot, will
look for "parrot_config" in your execution PATH, or the location
of parrot_config can be explicitly provided to via
the "--parrot_config" option:

    $ perl --parrot-config=/path/to/bin/parrot_config

If the Rakudo compiler is invoked without an explicit script to
run, it enters a small interactive mode that allows Perl 6 statements
to be executed from the command line.

To build and install "Blizkost" to gain the ability to use Perl 5
modules from Perl 6, use:

    $ make blizkost-install

Running the Perl 6 test suite
Entering "make rakudo-test" will run a small test suite that comes
bundled with Rakudo.  This is a simple suite of tests, designed
to make sure that the Rakudo compiler is basically working and that
it's capable of running a simple test harness.

Running "make spectest" in the rakudo/ subdirectory  will import 
the official Perl 6 test suite from the Pugs repository 
( and run all of these tests 
that are currently known to pass.

If you want to automatically submit the results of your spectest run
to a central server, use 'make spectest_smolder' instead. You need
the Perl 5 module 'TAP::Harness::Archive' and an active internet
connection for that. The smoke results are collected at

For more details about running tests, see rakudo/README .

Release information
Information about the current release is placed in the docs/
directory, here is a brief overview:

    docs/cheatsheet.txt   —   Perl 6 cheat sheet
    docs/announce/        —   detailed release announcements

Where to get help or answers to questions
The website contains a great many links to
resources for Perl 6 development, and is generally the starting
point for information about Perl 6.

There are several mailing lists, IRC channels, and wikis available
with help for Perl 6 and Rakudo on Parrot.  Figuring out the right
one to use is often the biggest battle.  Here are some rough

If you have a question about Perl 6 syntax or the right way to
approach a problem using Perl 6, you probably want the mailing list.  This list is primarily
for the people who want to use Perl 6 to write programs, as
opposed to those who are implementing or developing the Perl 6
language itself.

Questions about the Rakudo compiler for Parrot and the Parrot compiler 
tools can go to  Discussion about Parrot itself 
generally takes place on

The Rakudo and Parrot development teams tend to hang out on IRC a fair
bit, on and, respectively.

Rakudo's official web site is , where you can
find useful information for developers and users alike. 

Reporting bugs
Bug reports about Rakudo Star or the Perl 6 specification should be 
sent to with the moniker [BUG] (including the brackets) 
at the start of the subject so that it gets appropriately tagged in the 
RT system (  Please include or attach any sample 
source code that exhibits the bug, and include either the release name/date 
or the git commit identifier. You find that information in the output from
"perl6 --version".  There's no need to Cc: the perl6-compiler
mailing list, as the RT system will handle this on its own.

Submitting patches
Patches to the Rakudo compiler itself should be submitted to
''.  Patches for individual modules should be
submitted to the module authors (see the module source code for

We'll generally accept patches in any form if we can get them to work,
but unified diff from the 'git' command is greatly preferred.
See further instructions in the rakudo/ subdirectory for more details.
Other ways to create and submit patches are discussed at

Patrick Michaud ( is the primary author and
maintainer for Rakudo Star. See docs/CREDITS for further Rakudo
Star authors, and */CREDITS for authors of other collected

Something went wrong with that request. Please try again.