Getting Started


Install the latest build by going through our install section.


You can always make use of -h or --help flag to see how mutant can be used. This help feature is subject to evolve and improve over time.

mutant -h

Expected Output Mutant Help


Run following command to ensure that mutant has been installed successfully


If it is installed correctly, then you should be able to see a similar screen: Mutant REPL

To run the age old “Hello, World” program, use following code snippet following image should be your output:

puts("Hello, World!");

Mutant REPL

Code through mut file

All your mutant source code files will have extension mut, this extension is used by the compiler to read the source code and generate the compiled bytecode file with mu extension.

  1. Create a file named code.mut in any directory of your choice
  2. Write some mutant code in in that file using the IDE of your choice
  3. Run mutant code.mut to generate the compiled mu file with the same name in same directory
  4. Run mutant to run your compiled code

Releasing your builds

Mutant can generate self-contained, independent, executable binaries. Following are some examples:

  1. Basic Usage:
mutant release -src code.mut
  1. Cross Copmilation:
mutant release -src code.mut -os linux -arch 386