sona-lang 0.15.0

Sona Programming Language with Cognitive Accessibility and Neurodivergent-First Features

Sona

Sona is an AI-native programming language and developer toolchain focused on clear execution, readable diagnostics, deterministic examples, and cognitive accessibility.

Current release: 0.15.0

What Sona Provides

• A Python-hosted runtime and CLI for .sona programs.
• A stable first-run path for new developers.
• Clear user-facing diagnostics with actionable hints.
• A source-validated official example suite.
• Standard library documentation for the stable user-facing modules.

Install

Sona requires Python 3.11 or newer.

python -m pip install sona-lang

Confirm the install:

sona --version

Expected output shape:

Sona 0.15.0

First Run

The README does not assume access to repository examples. Create a local file first, then run it.

Bash or macOS/Linux shell:

echo 'print("Hello, Sona!")' > hello.sona
sona hello.sona

Windows PowerShell:

'print("Hello, Sona!")' | Out-File -Encoding utf8 hello.sona
sona hello.sona

Expected output:

Hello, Sona!

CLI Basics

sona --help
sona run hello.sona
sona hello.sona

Both sona run <file.sona> and sona <file.sona> are supported for local files.

Documentation

• Quickstart
• Language Reference
• Standard Library Reference
• Accessibility Reference
• Guardian Reference
• Diagnostics Guide
• Package Manifest
• Native Independence Roadmap
• Release Notes

Official Examples

Official examples are part of the source repository validation surface. They are not required to exist in installed Python packages.

From a source checkout:

python tools/run_examples.py
sona run examples/hello.sona

Repository Layout

sona/                         Core runtime, CLI, parser, and packaged stdlib
stdlib/                       Source .smod modules
docs/                         Current user-facing documentation
examples/                     Official source-checkout examples
tools/run_examples.py         Source-checkout example validator

Package Scope

The Python package is intentionally lean. Docs, examples, tests, extension sources, local reports, and build artifacts are source-repository materials and are excluded from release wheels and sdists.

Contributing

See CONTRIBUTING.md. Keep pull requests focused, document runtime-visible behavior, and do not commit local test files, temporary build output, or planning notes.

License

Sona is released under the MIT license. See LICENSE.