AiLang Examples

Curated examples for AiLangCore demos, tutorials, and conference walkthroughs.

This repository is intentionally separate from the core source repositories. Regression fixtures, golden tests, and tiny contract examples stay in the repos that own the behavior. This repo contains human-facing examples that should be easy to browse, run, and critique.

Examples

• examples/hello-cli - minimal command-line AiLang project.
• examples/hello-aivectra - minimal AiVectra package-based UI project.
• examples/package-demo - package restore workflow demo.

Requirements

Install the AiLangCore SDK:

curl -fsSL https://ailang.codes/install.sh | sh
export PATH="$HOME/.ailang/bin:$PATH"

Verify the installed tools:

ailang --version
aivm --version
aivectra --version

Validate Examples

./scripts/validate-examples.sh

The validation script builds every example and runs the command-line examples. The AiVectra example is an interactive UI app, so validation builds it and prints the manual launch command instead of opening a window in automation.

When validating from a local multi-repo checkout before the SDK installer has seeded the package registry, point the package manager at the sibling registry:

AILANG_PACKAGE_REGISTRY=/path/to/ailang-packages ./scripts/validate-examples.sh

Demo Flow

For a conference or meetup demo:

cd examples/hello-cli
ailang build .
ailang run .

cd ../hello-aivectra
ailang package restore
ailang build .
ailang run .

cd ../package-demo
ailang package restore
ailang package list
ailang build .
ailang run .

Repository Policy

Keep this repo focused on public demos:

• no golden regression fixtures
• no generated build artifacts
• no local SDK files
• no copied core source trees
• examples must use the public SDK flow unless explicitly documenting local development

Core behavior belongs in:

• AiLang
• AiVM
• AiVectra

Package records belong in:

• ailang-packages