Getting Started with Ovie

What is Ovie?

Ovie is a modern, self-hosted programming language designed to make programming accessible to everyone. Unlike traditional programming languages with cryptic syntax, Ovie uses natural language patterns that are easy to read and understand.

Key Features

• Self-Hosted: The Ovie compiler is written in Ovie itself
• Natural Syntax: Uses pidgin English keywords like seeAm instead of print
• Offline-First: Complete development environment with no network dependencies
• AI-Friendly: Designed for seamless AI/LLM integration
• Memory Safe: Built-in memory safety without garbage collection overhead
• Deterministic: Identical inputs always produce identical outputs

Installation

Getting Ovie installed on your system is quick and easy. Choose the method that works best for you:

Quick Install (Recommended)

Unix/Linux/macOS:

curl -sSL https://install.ovie-lang.org | sh

Windows (PowerShell):

iwr -useb https://install.ovie-lang.org/install.ps1 | iex

Build from Source (Offline)

For complete offline installation or if you want to build from source:

git clone https://github.com/southwarridev/ovie.git
cd ovie
make build
make install

Verify Installation

After installation, verify that Ovie is working correctly:

ovie --version

You should see output similar to:

Ovie Programming Language v1.0.0
Self-hosted compiler (written in Ovie)
Build: 2026-01-30

Your First Program

Let's create your first Ovie program! We'll start with the classic "Hello, World!" example.

Create a New Project

ovie new hello-world
cd hello-world

This creates a new Ovie project with the following structure:

hello-world/
├── ovie.toml          # Project configuration
├── src/
│   └── main.ov        # Main source file
└── tests/
    └── main.test.ov   # Test file

Write Your First Code

Open src/main.ov and replace the contents with:

// Hello World in Ovie - Self-Hosted Programming Language!
// This code is compiled by a compiler written in Ovie itself

seeAm "Hello, World!"
seeAm "Welcome to Ovie programming!"

// Let's try some variables
mut name = "Developer"
mut language = "Ovie"

seeAm "Hello, " + name + "!"
seeAm "You're learning " + language + " - the self-hosted language!"

Run Your Program

ovie run

You should see the output:

Hello, World!
Welcome to Ovie programming!
Hello, Developer!
You're learning Ovie - the self-hosted language!

Basic Syntax

Ovie's syntax is designed to be natural and readable. Here are the fundamental concepts:

Variables

// Immutable variables (default)
name = "Alice"
age = 25

// Mutable variables
mut counter = 0
mut score = 100

Functions

// Simple function
fn greet(name) {
    seeAm "Hello, " + name + "!"
}

// Function with return value
fn add(a, b) {
    return a + b
}

// Using functions
greet("World")
mut result = add(5, 3)
seeAm "5 + 3 = " + result

Control Flow

// Conditionals
mut age = 18

if age >= 18 {
    seeAm "You are an adult"
} else {
    seeAm "You are a minor"
}

// Loops
for i in 0..5 {
    seeAm "Count: " + i
}

// While loops
mut count = 0
while count < 3 {
    seeAm "Count: " + count
    count = count + 1
}

Data Structures

// Structs
struct Person {
    name: String,
    age: Number,
    email: String,
}

// Creating and using structs
mut person = Person {
    name: "Alice Johnson",
    age: 30,
    email: "alice@example.com",
}

seeAm "Name: " + person.name
seeAm "Age: " + person.age

Arrays and Collections

// Arrays
mut numbers = [1, 2, 3, 4, 5]
mut names = ["Alice", "Bob", "Charlie"]

// Accessing elements
seeAm "First number: " + array_get(numbers, 0)
seeAm "Array length: " + array_length(numbers)

// Adding elements
append(numbers, 6)
seeAm "New length: " + array_length(numbers)

Next Steps

Congratulations on completing your first steps with Ovie! Here's what you can explore next:

📚 Learn More

• Complete Language Guide - Comprehensive reference
• Tutorial Series - Step-by-step learning path
• Code Examples - Real-world examples

🛠️ Tools and Features

• CLI Reference - Master the command-line tools
• Aproko Assistant - Built-in code assistant
• Testing Framework - Write reliable tests

🏗️ Advanced Topics

• Self-Hosting Journey - How Ovie compiles itself
• Compiler Internals - Deep dive into the compiler
• AI Integration - Using Ovie with AI systems

🤝 Community

• GitHub Repository - Contribute to the project
• Discussions - Ask questions and share ideas
• Community Links - Connect with other developers

---