Quick Start Guide

From zero to your first Ifá-Lang program in 5 minutes

Installation

1 Install Ifá-Lang

Option A: GUI Installer (Recommended)

Download the cross-platform installer:

# Download from:
https://github.com/AAEO04/ifa_lang/releases

# Run the installer - it auto-detects your OS
# Choose a profile: Fusion (full), Standard, Developer, or Minimal

Option B: Command Line

# Windows (PowerShell)
irm https://github.com/AAEO04/ifa_lang/releases | iex

# macOS/Linux
curl -sSf https://aaeo04.github.io/ifa_lang/install.sh | sh

# Rust users
cargo install ifa-cli

See detailed installation for profiles and options

2 Verify Installation

ifa --version
Output:
Ifá-Lang v1.2.2

Hello World

3 Create your first program

Create a file called hello.ifa:

hello.ifa
// Ifá-Lang Hello World
ayanmo oruko = "Ifá";
Irosu.fo("Kaabo, " + oruko + "!");
// Ifá-Lang Hello World
let name = "Ifá";
Irosu.println("Hello, " + name + "!");

4 Run it!

ifa run hello.ifa
Output:
Kaabo, Ifá!

Variables and Types

variables.ifa
// Numbers
ayanmo iye = 42;
ayanmo owo = 3.14;

// Strings
ayanmo oruko = "Orunmila";

// Booleans
ayanmo otito_ni = otito;   // true
ayanmo iro_ni = iro;       // false

// Lists
ayanmo awon_nomba = [1, 2, 3, 4, 5];

// Null
ayanmo ohunkohun_ko_si = ohunkohun;
// Numbers
let count = 42;
let price = 3.14;

// Strings
let name = "Orunmila";

// Booleans
let is_true = true;
let is_false = false;

// Lists
let numbers = [1, 2, 3, 4, 5];

// Null
let nothing = null;

Control Flow

control.ifa
// If statement
ayanmo ?j?_ori = 18;

ti (?j?_ori >= 18) {
    Irosu.fo("O ti dagba!");
} bib?k? {
    Irosu.fo("O tun kere.");
}

// While loop
ayanmo i = 0;
nigba (i < 5) {
    Irosu.fo("Iye: " + i);
    ayanmo i = i + 1;
}

// For loop
ayanmo awon = [1, 2, 3];
fun n ninu awon {
    Irosu.fo(n);
}
// If statement
let age = 18;

if (age >= 18) {
    Irosu.println("You are an adult!");
} else {
    Irosu.println("You are still young.");
}

// While loop
let i = 0;
while (i < 5) {
    Irosu.println("Count: " + i);
    let i = i + 1;
}

// For loop
let items = [1, 2, 3];
for n in items {
    Irosu.println(n);
}

Using Odù Domains

domains.ifa
// Irete - Crypto operations
ayanmo hash = Irete.sha256("ifá");
Irosu.fo("SHA256: " + hash);

// Osa - Parallel operations
ayanmo awon = [1, 2, 3, 4, 5];
ayanmo apap? = Osa.sum(awon);
Irosu.fo("Sum: " + apap?);

// Ogbe - System info
ayanmo eto = Ogbe.eto();
Irosu.fo("OS: " + eto);
// Irete - Crypto operations
let hash = Irete.sha256("ifá");
Irosu.println("SHA256: " + hash);

// Osa - Parallel operations
let numbers = [1, 2, 3, 4, 5];
let total = Osa.sum(numbers);
Irosu.println("Sum: " + total);

// Ogbe - System info
let os = Ogbe.eto();
Irosu.println("OS: " + os);

Next Steps

?? Philosophy

Learn about the 16 Odù domains

?? Examples

More complete programs

?? Error Handling

Debugging and troubleshooting

?? Playground

Try Ifá-Lang in your browser