Fast · Safe · Minimal
Documentation v0.1.0

Nyra Programming Language

Fast like a panther. Sharp by design.

Go’s simplicity. Rust’s safety. C++’s speed — one toolchain, LLVM under the hood.

  • Fast
  • Safe
  • Minimal
  • LLVM native
Get started Install Built-in methods
Nyra 
curl -fsSL https://raw.githubusercontent.com/nyra-lang/nyra/main/scripts/install.sh | sh
nyrapkg (package manager) 
curl -fsSL https://raw.githubusercontent.com/nyra-lang/pkg/main/scripts/install.sh | sh

Then: source ~/.zshrc · full install guide

What is Nyra?

Production-ready systems language — readable surface, strict core, LLVM-native speed.

Source

Programs live in .ny files. A Nyra frontend emits LLVM IR, then clang links the Nyra runtime for I/O and runtime helpers.

Philosophy

Go-like control flow and a small keyword set, Rust-like compile-time memory rules, and native speed from LLVM optimizations.

One CLI

nyra run, build, test, fmt, and pkg — one toolchain from hello world to release binaries.

Toolchain docs →

Design pillars

What we borrow — and what ships today.

Ease

Go

Flat syntax, fn main, minimal boilerplate

Safety

Rust

Ownership, auto-drop, NLL borrows — no GC, no leaks in normal code

Ownership UX →
Speed

LLVM

nyra build --release, thin LTO, IR opt

Tooling

Go-style CLI

run, build, test, fmt, pkg in one binary

Async

Go

spawn with captures, Send/Sync, pthread channels

Compilation pipeline

From source to native executable.

1 Source .ny files
2 Frontend Lexer · Parser · Types · Ownership · Borrow · Lifetimes · Send/Sync
3 LLVM IR opt passes
4 Native binary clang + Nyra runtime

Result & error handling

Stable Extended Result payloads with ? propagation for fallible pipelines.

Shipped (Stable Extended)

The ? operator, generic Result<T,E> via import "stdlib/option.ny", and tests such as tests/nyra/result_propagate_test.ny.

Still maturing

Some exotic generic serde edge cases — see roadmap production gates.

For AI assistants

Download the canonical Nyra reference for Cursor, ChatGPT, Claude, and other LLMs.

Single file nyra-skill.md — syntax, ownership, stdlib, PGO, escape analysis, stability tiers, and anti-hallucination guardrails.

Download nyra-skill.md Usage guide Learning path

Explore the docs

Pick a path — beginner to reference app.

New to programming?

Beginner track

Eight step-by-step lessons — first program through a mini project
Start here

Getting started

Create a project, run Hello World, understand nyra run .
Reference

Built-in methods

Every builtin and stdlib method — with a runnable example per row

Installation

macOS, Linux, Windows — releases & tags

Learn Nyra

Step-by-step tutorials — every topic with runnable code

Imports guide

Functions, structs, enums, consts

Language syntax

Variables, loops, match, functions

Toolchain

build, test, fmt, release flags
API reference

Standard library

Strong stdlib — collections, FS, HTTP/TCP, crypto, DB, serde, WebSocket in-tree

Language reference

Keywords, operators, ownership quick ref

Memory & ownership

NLL, lifetimes, Drop, Send/Sync, auto-drop

Language spec

Normative Spec 1.0 (v0.2 freeze)

Learning path

Zero to full app — step by step
Project status Nyra is production-ready on Core + Stable Extended (async, ?, spawn, traits, serde). Prebuilt releases for Linux, macOS, and Windows. See Roadmap, status.md, and stability policy.