Getting Started — Mapanare

Install Mapanare and write your first program in under a minute.

Add the Skill

Give your AI coding agent full Mapanare fluency — syntax, types, idioms, CLI commands, and best practices:

npx skills add Mapanare-Research/skills

Works with Claude Code, Cursor, Windsurf, and any skills-compatible agent.

Install the Compiler

Linux / macOS:

curl -fsSL https://mapanare.dev/install | bash

Windows (PowerShell):

irm https://mapanare.dev/install.ps1 | iex

Your First Program

Create a file called hello.mn:

fn main() {
    print("Hello, Mapanare!")
}

Run it: mapanare run hello.mn

Your First Agent

Agents are concurrent actors with typed input/output channels:

agent Greeter {
    input name: String
    output greeting: String

    fn handle(name: String) -> String {
        return "Hello, " + name + "!"
    }
}

fn main() {
    let greeter = spawn Greeter()
    greeter.name <- "World"
    let result = sync greeter.greeting
    print(result)  // Hello, World!
}

Key concepts: agent defines a concurrent actor. spawn creates an instance. <- sends a message. sync waits for output.

Compilation Modes

Python Transpiler — Emits readable Python. Access the entire Python ecosystem. Command: mapanare compile hello.mn

LLVM Native — Compiles to native binaries via LLVM IR. Up to 63x faster than Python. Command: mapanare build hello.mn

Project Structure

Initialize a new project: mapanare init my-project. This creates a project directory with a mapanare.toml manifest and a src/main.mn entry point.