{"id":50844186,"url":"https://github.com/suhteevah/aether","last_synced_at":"2026-06-14T08:05:47.734Z","repository":{"id":355366918,"uuid":"1227223262","full_name":"suhteevah/aether","owner":"suhteevah","description":"AI-native systems language. Close to the metal, LLM-readable, comments stripped at lex time.","archived":false,"fork":false,"pushed_at":"2026-06-06T02:43:53.000Z","size":7137,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-06T04:20:34.901Z","etag":null,"topics":["ai","autodiff","compiler","jit","llm","machine-learning","programming-language","rust","systems-programming"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/suhteevah.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP_V2.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-02T11:36:42.000Z","updated_at":"2026-06-06T02:43:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/suhteevah/aether","commit_stats":null,"previous_names":["suhteevah/aether"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/suhteevah/aether","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suhteevah%2Faether","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suhteevah%2Faether/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suhteevah%2Faether/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suhteevah%2Faether/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/suhteevah","download_url":"https://codeload.github.com/suhteevah/aether/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suhteevah%2Faether/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34313649,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","autodiff","compiler","jit","llm","machine-learning","programming-language","rust","systems-programming"],"created_at":"2026-06-14T08:05:45.919Z","updated_at":"2026-06-14T08:05:47.730Z","avatar_url":"https://github.com/suhteevah.png","language":"Rust","funding_links":["https://www.paypal.me/baal_hosting","https://paypal.me/baal_hosting"],"categories":[],"sub_categories":[],"readme":"# Aether\n\nAI-native systems language. Close to the metal, LLM-readable, comments stripped at lex time.\n\nSee `SPEC.md` for the full spec, war doc, and roadmap. See `CLAUDE.md` for coder/agent instructions, and `HANDOFF.md` for the latest session state.\n\n## Build\n\n```\ncargo build --workspace --release\ncargo test  --workspace\n```\n\n## Audit\n\n```\npowershell -ExecutionPolicy Bypass -File scripts\\audit.ps1\n```\n\nSingle-command honesty audit: SLOC per crate, every stub / panic / unsafe / `Phase N` marker surfaced with file:line, golden-artifact diffs, language-conformance suite (positive samples must check clean, negative samples must fail with a specific `AE####` code). Run it before claiming any work is done.\n\n## Train a model\n\nAetherLM-Nano (~85K params) on a synthetic corpus, CPU only, no framework deps:\n\n```\n.\\target\\release\\aether-train.exe --config nano --steps 60 --batch 8 --seq 32 --lr 3e-3\n.\\target\\release\\aether-infer.exe --ckpt checkpoints\\aether_lm --prompt \"the quick\" --max-new 60\n```\n\nLoss drops from ~5.5 to ~0.8 in under 10 seconds. Sampled text reproduces fragments of the training corpus. **Every tensor operation goes through `runtime/src/lib.rs`'s C-ABI surface — no candle, no torch, no framework.** When aetherc Phase 1 lands, the same binary will be emitted directly from `examples/aether_lm.aether`.\n\n## Compile to a native binary through Aether's own assembler\n\n```\ntarget\\release\\aetherc.exe examples\\00_hello.aether --emit=aether-bin -o hello.exe\n.\\hello.exe\n```\n\nThis walks: `.aether` source → x86-64 AT\u0026T assembly (aetherc backend) → 252-byte COFF .obj (`aether_asm/`, our own x86-64 instruction encoder + PE32+ writer) → linked .exe. **No LLVM, no C compiler, no GAS.** The system linker is the last external tool — replaced in Phase 5.\n\nYou can also stop at intermediate stages:\n\n```\ntarget\\release\\aetherc.exe examples\\00_hello.aether --emit=asm\ntarget\\release\\aether-asm.exe hello.s -o hello.obj\n```\n\n## Inspect the language\n\n```\ntarget\\release\\aetherc.exe examples\\aether_lm.aether --check\ntarget\\release\\aetherc.exe examples\\aether_lm.aether --emit=mir\ntarget\\release\\aetherc.exe examples\\aether_lm.aether --emit=llvm-ir\n```\n\n## Layout\n\n* `compiler/` — `aetherc` (Rust, bootstrap). Lexer (comment-stripping), parser, AST, MIR + autodiff graph, LLVM text emitter, C fallback, **and direct x86-64 assembly backend**.\n* `aether_asm/` — our own x86-64 instruction encoder and Windows PE32+ COFF writer. Phase 5 rewritten in Aether.\n* `runtime/` — `libaether_rt`. Thin C-ABI shim with **real f32 CPU implementations** of matmul, gelu, softmax, layer_norm, scaled-dot-product-attention, cross_entropy, AdamW, and all their backwards. Phase 1 swaps each body to cuBLAS / cuDNN / NCCL — symbol surface stays identical. `runtime/ABI.md` is the contract.\n* `trainer/` — Rust binaries (`aether-train`, `aether-infer`, `aether-prepare`) that call **only** runtime symbols. What aetherc Phase 1 will emit from the Aether source.\n* `stdlib/` — `.aether` source for the language stdlib (`ops`, `optim`, `nn`, `tensor`). Every primitive op is an `extern fn` resolving to a runtime symbol.\n* `examples/` — `.aether` programs: hello, matmul, distributed training, LLM serving, and `aether_lm.aether` (AetherLM-Tiny in pure Aether).\n* `docs/`, `SPEC.md`, `CLAUDE.md`, `HANDOFF.md` — design + session state.\n\n## Philosophy\n\nAether is the language; cuBLAS/cuDNN/NCCL are the bare-metal targets. Nothing in between. No PyTorch, no candle, no JAX, no XLA. The Rust runtime is a bootstrap concession — Aether self-hosts in Phase 5.\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n---\n\n## Support This Project\n\nIf you find this project useful, consider buying me a coffee! Your support helps me keep building and sharing open-source tools.\n\n[![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?logo=paypal)](https://www.paypal.me/baal_hosting)\n\n**PayPal:** [baal_hosting@live.com](https://paypal.me/baal_hosting)\n\nEvery donation, no matter how small, is greatly appreciated and motivates continued development. Thank you!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuhteevah%2Faether","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuhteevah%2Faether","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuhteevah%2Faether/lists"}