Getting Started

This guide helps you go from zero to your first running Numo file in just a few steps.

Create your project

First, of all, let’s start by creating a new project in our current directory:

numo init

This will get you the following file structure:

• numo.toml
• main.numo
• …

Run the following command to see the default “Hello, World!” program in action:

numo main.numo

Your done! You just ran your first Numo program.

Format your code

Use either command:

numo /path/to/file.numo --format

numo /path/to/file.numo --fmt

Formatting updates the file in place.

Tip

Formatting is a great way to keep your code clean and consistent. It is recommended to format your code before sharing it with others or committing it to version control. You could also set up in your IDE to format on save, so you don’t have to think about it at all.

Compile to a standalone executable

You can package your Numo source into a native executable:

numo compile app.numo -o app
./app

This output binary embeds your source and applies automatic size optimization, resulting in a compact executable that runs without needing the Numo runtime installed.

Note

Numo tries to make your binary as small and fast as possible by stripping symbols and applying optional UPX compression. However, the exact size and performance may vary based on Numo’s runtime code.