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.1

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 stable user-facing modules.
• Cognitive accessibility references for supported developer workflows.
• Guardian runtime documentation for local resilience and release trust surfaces.

Install

Sona requires Python 3.11 or newer.

Install the published Python package:

python -m pip install sona-lang

Confirm the install:

sona --version

Expected output shape:

Sona 0.15.1

Note: the source repository may be ahead of the latest published PyPI package. For the newest source release, install from a source checkout.

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

VS Code

Sona has VS Code ecosystem support through the Sona editor tooling and companion extensions.

• The main Sona VS Code extension provides syntax highlighting, command palette actions, and editor workflow support for .sona and .smod files.
• The Sona Receipt Explorer visualizes and compares Sona execution receipt files.

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
.github/workflows/ci.yml      Continuous integration workflow
vscode-extension/             Main Sona VS Code extension
extensions/sona-receipt-explorer/
                              Receipt Explorer VS Code extension

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.