,dPYb,                                     ,dPYb,
 IP'`Yb                                     IP'`Yb
 I8  8I                                gg   I8  8I
 I8  8bgg,                             ""   I8  8'
 I8 dP" "8    ,ggggg,    ,ggg,,ggg,    gg   I8 dP    ,ggggg,
 I8d8bggP"   dP"  "Y8ggg,8" "8P" "8,   88   I8dP    dP"  "Y8ggg
 I8P' "Yb,  i8'    ,8I  I8   8I   8I   88   I8P    i8'    ,8I
,d8    `Yb,,d8,   ,d8' ,dP   8I   Yb,_,88,_,d8b,_ ,d8,   ,d8'
88P      Y8P"Y8888P"   8P'   8I   `Y88P""Y88P'"Y88P"Y8888P"

Clone The Repository

fossil clone http://fossils.retroforth.org:8000/ilo konilo.fossil
mkdir konilo
cd konilo
fossil open ../konilo.fossil 

Updates

cd konilo
fossil update

Required Files

Konilo has three parts: the ilo virtual machine, an image file containing the actual Konilo language, and a file containing the data blocks available to the system.

+------------+------------------------+
| file       | contains               |
+============+========================+
| ilo.c      | ilo source code        |
| ilo.rom    | konilo image           |
| ilo.blocks | standard set of blocks |
+------------+------------------------+

The ilo.rom and ilo.blocks need to be in the current working directory when you start ilo.

Build ilo

The most commonly used implementation of ilo is written in C.

make ilo

If you would prefer to avoid C, several other options (including C#, Common Lisp, Go, Kotlin, Lua, Nim, Python, Rust, and Swift) are provided. Look at vm/README.txt for details on these.

Run

./ilo

Build The Image

The standard Konilo image is provided as ilo.rom. If you want to rebuild it, you can run:

make ilo.rom

This is not necessary in most cases, but can be beneficial if you would like to have a system that has additional functionality built in.