{"id":51164175,"url":"https://github.com/alexmelanfromringo/aurora","last_synced_at":"2026-06-26T17:01:38.844Z","repository":{"id":364647280,"uuid":"1268708655","full_name":"AlexMelanFromRingo/aurora","owner":"AlexMelanFromRingo","description":"A modern, batteries-included overlay distribution for OpenComputers OpenOS — package manager (opm), dev toolchain/compilers, networking, shell themes, and security fixes. 100% OpenOS-compatible.","archived":false,"fork":false,"pushed_at":"2026-06-13T22:45:18.000Z","size":285,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-13T23:10:54.911Z","etag":null,"topics":["cli","compiler","emulator","lua","lua53","minecraft","opencomputers","openos","operating-system","overlay","package-manager","transpiler"],"latest_commit_sha":null,"homepage":"https://alexmelanfromringo.github.io/aurora/","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlexMelanFromRingo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"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-06-13T21:05:14.000Z","updated_at":"2026-06-13T22:45:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AlexMelanFromRingo/aurora","commit_stats":null,"previous_names":["alexmelanfromringo/aurora"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/AlexMelanFromRingo/aurora","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexMelanFromRingo%2Faurora","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexMelanFromRingo%2Faurora/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexMelanFromRingo%2Faurora/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexMelanFromRingo%2Faurora/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexMelanFromRingo","download_url":"https://codeload.github.com/AlexMelanFromRingo/aurora/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexMelanFromRingo%2Faurora/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34825611,"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-26T02:00:06.560Z","response_time":106,"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":["cli","compiler","emulator","lua","lua53","minecraft","opencomputers","openos","operating-system","overlay","package-manager","transpiler"],"created_at":"2026-06-26T17:01:37.131Z","updated_at":"2026-06-26T17:01:38.833Z","avatar_url":"https://github.com/AlexMelanFromRingo.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aurora\n\n[![ci](https://github.com/AlexMelanFromRingo/aurora/actions/workflows/ci.yml/badge.svg)](https://github.com/AlexMelanFromRingo/aurora/actions/workflows/ci.yml)\n[![release](https://img.shields.io/github/v/release/AlexMelanFromRingo/aurora?sort=semver)](https://github.com/AlexMelanFromRingo/aurora/releases)\n[![license](https://img.shields.io/github/license/AlexMelanFromRingo/aurora)](LICENSE)\n![lua](https://img.shields.io/badge/Lua-5.3-blue)\n[![docs](https://img.shields.io/badge/docs-pages-brightgreen)](https://alexmelanfromringo.github.io/aurora/)\n\n**A modern, batteries-included overlay distribution for OpenComputers OpenOS.**\n\nAurora takes a stock [OpenOS](https://ocdoc.cil.li/) install and layers on a real\npackage manager, a developer toolchain (\"compilers\"), networking libraries, shell\nthemes, and security + reliability fixes — **without breaking OpenOS\ncompatibility**. Anything that runs on stock OpenOS keeps running; Aurora just\nmakes the system far more capable and pleasant to use.\n\nIt installs *on top of* an existing OpenOS (as an overlay + a couple of targeted\ncore patches), so there is nothing to re-learn and nothing to lose.\n\n📖 **Documentation site:** \u003chttps://alexmelanfromringo.github.io/aurora/\u003e ·\n[API reference](docs/API.md) · [Architecture](docs/ARCHITECTURE.md) ·\n[Patches](docs/PATCHES.md)\n\n---\n\n## Highlights\n\n| Area | What you get |\n|------|--------------|\n| 📦 **Packages** | `opm` — install/remove/update/search with semver dependency resolution and **sha256-verified, atomic** downloads from a GitHub-hosted registry |\n| 🛠️ **Dev toolchain** | `acc` (compile = transpile→lint→bundle→minify), `aminify` (Lua-aware minifier), `abundle` (require-graph linker), `atpl` (compound-assignment transpiler), `alint` (**scope-aware** linter on a real Lua AST), `afmt` (AST-based code formatter), `adoc` (API-doc generator), `atest`, `arepl` |\n| 🌐 **Networking** | `ahttp` (status-checked HTTP with JSON + verified downloads), `anet` (modem messaging + JSON-RPC 2.0) |\n| 🎨 **Shell \u0026 UX** | `atheme` color themes, configurable prompt, `afetch` system summary, `alocale` (i18n: English + Russian), curated aliases |\n| 🔒 **Security \u0026 reliability** | patched `wget` (checks HTTP status, atomic, `--sha256`), `cp` crash fix, `strict` global guard, safe-remove, `asandbox` (run untrusted Lua with no system access) |\n| 🧰 **Libraries** | `json`, `inspect`, `class`, `argparse`, `aurora.hash` (SHA-256/CRC-32), `aurora.semver`, `aurora.fsx`, `aurora.util`, `aurora.optimize` |\n\nEvery shipped Lua file is syntax-linted, every pure module is unit-tested on the\nhost (**112 tests**), and the whole distribution is booted and self-tested inside\na real OpenOS under an emulator (**15 in-VM checks**, including the data card's\nhardware SHA-256).\n\n---\n\n## Install\n\n### Online (recommended)\n\nOn any OpenOS machine with an internet card:\n\n```sh\nwget https://raw.githubusercontent.com/AlexMelanFromRingo/aurora/main/install/install.lua /tmp/ai.lua\n/tmp/ai.lua\n```\n\nThe installer fetches a checksummed manifest, **verifies every file's sha256**,\nwrites atomically, backs up any core file it patches (`*.orig-aurora`), and wires\na guarded login hook. It is idempotent — safe to re-run. Open a new shell or\nreboot afterwards.\n\n### Offline (patch overlay)\n\nClone or copy this repository onto a disk the machine can see, then:\n\n```sh\n/mnt/\u003cdisk\u003e/install/apply.lua /mnt/\u003cdisk\u003e\n```\n\nThis applies the same overlay + patches with no network, verifying checksums\nfrom the local copy.\n\n---\n\n## Quick tour\n\n```sh\nafetch                         # system summary\natheme set matrix              # switch shell theme (persists)\n\nopm update                     # refresh package lists\nopm install acowsay            # install a package (sha256-verified)\nacowsay \"hello from Aurora\"\n\narepl                          # nicer Lua REPL (multiline, pretty-print)\n\n# compile a multi-file project into one minified, linted file:\nacc src/main.lua -o build/app.lua\n\n# safer downloads:\nawget --sha256=\u003chex\u003e https://host/file.lua /usr/bin/file.lua\n```\n\nEvery command has a man page (`man opm`, `man acc`, …) and `--help`.\n\n---\n\n## Using the libraries in your programs\n\n```lua\nlocal json   = require(\"json\")\nlocal ahttp  = require(\"ahttp\")\nlocal class  = require(\"class\")\n\nlocal res = ahttp.getJSON(\"https://api.example.com/status\")\nprint(json.encode(res, {pretty = true}))\n\nlocal Animal = class(\"Animal\")\nfunction Animal:init(name) self.name = name end\n```\n\nSee [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) for the full library map.\n\n---\n\n## Repository layout\n\n```\noverlay/     files laid over OpenOS (bin/, lib/, etc/, usr/man/)\npatches/     patched core files + pristine *.orig + rationale\ninstall/     install.lua (online), apply.lua (offline), manifest.lua\nregistry/    opm package registry (index.json + packages/)\ntools/       build.sh, test.sh, lint.sh, integration.sh, generators\ntests/       host unit tests + OpenComputers shim + in-VM self-test\ndocs/        ARCHITECTURE.md, PATCHES.md, design spec\n```\n\n---\n\n## Developing \u0026 testing\n\n```sh\ntools/lint.sh            # syntax-lint every Lua file (luac5.3 -p)\ntools/test.sh            # lint + host unit tests + in-VM integration\ntools/test.sh --no-integration   # skip the emulator step\ntools/build.sh           # regenerate manifest + registry after edits\n```\n\nHost unit tests run pure-Lua modules under `lua5.3` against an OpenComputers\nshim. The integration step stages stock OpenOS + Aurora into a throwaway\ninstance and boots it under [`ocvm`](https://github.com/payonel/ocvm), running an\nin-system self-test. See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md#testing).\n\n---\n\n## Compatibility\n\n- OpenComputers 1.7+, OpenOS, Lua 5.3.\n- The data card (SHA-256, deflate) is used when present, with pure-Lua\n  fallbacks — nothing *requires* a particular tier.\n- Aurora never replaces the OpenOS boot path, `require`, or component model.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexmelanfromringo%2Faurora","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexmelanfromringo%2Faurora","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexmelanfromringo%2Faurora/lists"}