🚀 Sona — AI-Native Programming Language
Human × AI collaboration with cognitive accessibility at the core.
Sona lets you think in code and code in plain language—with accessibility features that respect how different brains work.
TL;DR
- AI-Native from first principles. Sona speaks with you as you build—explain, review, plan, optimize.
(Provider integrations ship via the separate
sona-ai package.)
- Cognitive accessibility, seriously. Focus patterns and working memory helpers designed to reduce overwhelm.
- Pragmatic interop. Use Sona to think clearly; emit to the stacks your team ships.
If this resonates, ⭐️ star the repo. Stars help prioritize what you’ll actually use.
✨ What’s New in v0.9.4.1 (Credibility Hotfix)
This hotfix fixes Marketplace presentation and stdlib packaging integrity.
Extension polish: proper Overview, icon, banner, screenshots, keywords, and Q&A enabled
Stdlib packaging: wired and validated (22+ modules), MANIFEST.json added to prevent drift
JSON upgrades held steady: RFC 7396 merge_patch, JSON Pointer helpers, and deep_update(target, patch, *, list_strategy="replace"|… , make_copy=True)
- Back-compat: legacy
copy= still works with a DeprecationWarning
Deterministic testing: Windows + Python 3.12 with SONA_DEBUG=1, stdlib-only coverage gate ≥85% (current ~86%)
Regex confirmations: explicit timeout semantics retained; count=0 means unlimited
You’re not looking for hype; you’re looking for a backbone. v0.9.4.1 is the credibility pass.
🧠 AI-Native Programming (First-Class)
Status: concept & ergonomics shown below; provider integrations arrive via sona-ai so the stdlib remains stable.
// AI-powered collaboration (via sona-ai provider package)
ai_complete("create a secure login function")
ai_explain(complex_code, "beginner")
ai_debug("null pointer", "authentication context")
ai_optimize("slow database queries")
ai_review(code_context)
🧭 Cognitive Programming (Accessibility Pioneer)
// Reduce cognitive load, on purpose
working_memory("user authentication flow", "load")
focus_mode("debugging session", "25min")
cognitive_check("high complexity")
simplify("OAuth implementation", "intermediate")
break_down("complex user interface")
💬 Natural Language Programming
// Conversational thinking to executable steps
explain("This function validates user input and handles edge cases")
think("What's the best way to optimize this algorithm?")
intend("create a secure, scalable user management system")
📦 What’s Solid Right Now (v0.9.4.1 baseline)
JSON
RFC 7396 Merge Patch: merge_patch(target, patch) (documented & tested)
JSON Pointer helpers (with “pointer gotchas” documented)
deep_update: deep_update(target, patch, *, list_strategy="replace"|"append"|"extend_unique", make_copy=True)
- Dicts recurse; lists replace by default; back-compat shim accepts legacy
copy=
Collections: chunk, unique_by, group_by (order-preserving, tested)
Regex: reusable handles, explicit timeouts (timeout_ms), safe failure modes
Quality (Windows, Python 3.12, SONA_DEBUG=1)
- Tests: PASS; stdlib-only coverage gate ≥85%
- Deterministic: no network deps in core tests
🚀 Quick Start
Install (Python 3.12+)
pip install sona==0.9.4.1
# or with extras
pip install "sona[ai]==0.9.4.1" # AI-related provider package (separate)
pip install "sona[dev]==0.9.4.1" # tooling for devs
Verify Your Environment
sona build-info
sona doctor
First Run
# REPL
sona repl
// inside REPL
explain("Learning the world's first AI-native language!")
working_memory("data processing concept", "load")
focus_mode("learning Sona", "20min")
🧩 VS Code Integration
The extension brings Sona’s cognitive patterns into your daily workflow without fighting your editor muscle memory.
🔧 CLI (snapshot)
sona init <project> # Create new project
sona run <file> # Execute Sona files
sona repl # Interactive REPL
sona transpile <file> # Convert to other languages
sona format <file> # Format code
sona check <file> # Syntax validation
sona info # Environment information
sona build-info # Build metadata + feature flags
sona doctor # System diagnostics
🔀 Multi-Language Transpilation
sona transpile app.sona --target javascript
sona transpile app.sona --target typescript
sona transpile app.sona --target python
sona transpile app.sona --target csharp
sona transpile app.sona --target go
sona transpile app.sona --target rust
Use Sona to think clearly; emit to the stack your team ships.
🧪 Cognitive Example (Short)
working_memory {
current_task = "Data processing";
cognitive_load = "medium";
next_steps = ["validate", "process", "save"];
}
when data_arrives {
think("New data needs processing");
focus("Data validation");
result = validate_input(data);
if (result.valid) {
process_data(result.data);
} else {
handle_error(result.errors);
}
}
Output:
[THINK] New data needs processing
[FOCUS] Data validation
Processing complete: 42 records
Who Uses Sona Today?
- Neurodivergent devs who want tools that respect focus, pacing, and cognitive load
- Educators & students who want explanations as they code
- Teams that want one thinking surface and many targets
If that resonates, ⭐️ star now and watch the roadmap land.
Docs & Resources
- Wiki: https://github.com/Bryantad/Sona/wiki
- Getting Started:
docs/installation.md, docs/quickstart.md
- Language Reference:
docs/language-reference.md
- Cognitive Features:
docs/cognitive-features.md
- CLI Reference:
docs/cli-reference.md
- Transpilation:
docs/transpilation.md
- VS Code Guide:
docs/vscode-extension.md
Roadmap (near-term)
- LSP: diagnostics, semantic tokens, quick-fixes for common stdlib usage
- Transpilation: practical multi-language codegen for a clear subset of constructs
- Package manager: publishing/consumption with lockfile & integrity checks
- AI integration via
sona-ai: provider-agnostic, safe-by-default, testable offline
We’ll land these without compromising stdlib stability.
If you build something cool with Sona, we’ll showcase it.
License
