Visual identity for the public-facing repo: - Phoenix logo (red, with Syn_OS wordmark) at the top of README as hero - Phoenix-white variant in the footer band for visual symmetry - Sanctum wallpaper added to assets/ (available for embed where useful) - Four no-fake-stats badges: pre-release status, Sun & Salt codename, Rust language tag, CC-BY-SA docs license Assets directory created at assets/ holding only what's safe to publish: phoenix.png, phoenix-white.png, synos-sanctum.png. Live desktop screenshot and oversized wallpapers omitted (privacy + repo size). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
143 lines
7.1 KiB
Markdown
143 lines
7.1 KiB
Markdown
<div align="center">
|
||
|
||
<img src="./assets/phoenix.png" alt="Syn_OS — the synaptic operating system" width="280" />
|
||
|
||
# Syn_OS
|
||
|
||
### v60.0.0 — "Sun & Salt"
|
||
|
||
*An AI-native cybersecurity operating system, built almost entirely in Rust, designed for those who treat security as craft.*
|
||
|
||
[]()
|
||
[]()
|
||
[]()
|
||
[](LICENSE)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## the gap
|
||
|
||
Syn_OS — the **Synaptic Operating System** — takes its name from the *synaptic gap*: the space between neurons where electrical signal becomes meaning. The underscore is deliberate. It points at the moment translation happens — between hardware and intent, between tool and operator, between threat and response.
|
||
|
||
Syn_OS is built on a different premise than the security-distro lineage that came before: **the operating system itself can carry intelligence.** Not as a chatbot bolted onto the desktop. As a substrate. A kernel that reasons. A daemon that learns the shape of your work. A training environment where every challenge teaches the muscle for the next one.
|
||
|
||
---
|
||
|
||
## what's in v60
|
||
|
||
The platform that ships as Syn_OS today is the result of a sustained, multi-year build.
|
||
|
||
- **Custom Linux 6.19 kernel** with `CONFIG_RUST=y` and **17 custom system calls** (numbered 469–485) that expose consciousness state, quantum memory entanglement, eBPF instrumentation, kernel observability, and process attestation directly to userspace.
|
||
- **160-crate Rust workspace.** Zero compile errors. Memory safety where memory safety matters.
|
||
- **ALFRED v5** — the AI daemon. 11-region neuroanatomically-modeled brain. Local inference via Ollama and ONNX. No cloud in the critical path.
|
||
- **GRIMOIRE** — the gamified cybersecurity training platform. **100 hand-authored labs across 13 categories.** Faction system. XP economy. Boss contracts. Branching narrative quests. Maps to **11 professional certification paths.** Read more in [GRIMOIRE.md](./GRIMOIRE.md).
|
||
- **synos-bevy** — Bevy 0.14 game engine, 8 plugins, ~7,000+ lines of immersive desktop experience.
|
||
- **Arcanum Hive** — 8-node Tailscale mesh + Kubernetes operator. Sovereign coordination across distributed hardware.
|
||
- **Post-quantum cryptography** — ML-KEM, ML-DSA, and SLH-DSA built into the trust toolkit.
|
||
- **41-stage self-healing build pipeline** producing three signed ISOs from a single source tree.
|
||
- **1,600+ tests, 100% pass rate**, 35% tarpaulin coverage floor.
|
||
- **MkDocs Material documentation** site, version-aware, checked against the source.
|
||
|
||
---
|
||
|
||
## the v44 → v60 codesprint, in one breath
|
||
|
||
Sixteen versions of compounding work shipped between v44 and v60:
|
||
|
||
| Codename | Theme |
|
||
|---|---|
|
||
| **v44 Crucible** | Fuzz harness + observability kernel + rebuild-verify CI |
|
||
| **v45 Glasswalker** | Kernel observability syscalls (480–485) — eBPF, perf, attestation |
|
||
| **v46 Beachhead** | Process attestation HMAC ledger + LSM hooks |
|
||
| **v51 Storm Glass** | TwinPlugin (8th synos-bevy plugin) + kernel snapshot |
|
||
| **v55 Stoneglass** | Hive Ansible deploy (8-node GA playbook) |
|
||
| **v56 (Rust Ratchet)** | Kernel hot-path Rust at 83.54% |
|
||
| **v60 Sun & Salt** | SBOM drift detector + IPO readiness self-test + external blocker playbook |
|
||
|
||
The first ISO carrying the full codesprint ships as v60.
|
||
|
||
---
|
||
|
||
## the three-image strategy
|
||
|
||
Syn_OS is built once and ships in three signed ISOs.
|
||
|
||
| Image | Audience | What it carries |
|
||
|---|---|---|
|
||
| **Operator (Master)** | The team that builds Syn_OS. Internal. | The full surface. Not distributed publicly. |
|
||
| **GRIMOIRE Public** | Students, cohorts, self-taught practitioners. | The 100-lab training platform, gated tooling, mixed Apache 2.0 + GRIMOIRE-Public license. |
|
||
| **Goodlife** | AI researchers, post-quantum experimenters, civilian work. | Jupyter + 10-package research stack, ALFRED `research-mode`, LUKS-encrypted research data. |
|
||
|
||
The boundaries between images are mechanically enforced — not honor-system. What ships, ships clean.
|
||
|
||
---
|
||
|
||
## what we promise
|
||
|
||
- **No cloud in the critical path.** ALFRED runs on your machine. Inference happens locally. The system does not require a network connection to be useful.
|
||
- **No telemetry without consent.** The default state is silent. Anything that crosses the boundary of the box, you approve.
|
||
- **Memory-safe by default.** The Rust ratchet (v56) is a one-way commitment — kernel hot paths and userspace foundations move toward Rust, never away.
|
||
- **Post-quantum-ready.** Cryptography in the system is being built for the cryptographic transition that's underway, not the one that ended.
|
||
- **Reproducible builds.** SLSA-3 reproducible build pipeline. SBOM (CycloneDX) per ISO. Dual-witness signature support across mesh nodes.
|
||
- **Sigstore-signed releases.** Cosign-signed ISOs with Rekor transparency log entries. Verifiable provenance from build oracle to your USB stick.
|
||
- **Sovereignty as a design property.** You own your infrastructure, your intelligence, your future. Mechanically. Cryptographically. Architecturally.
|
||
- **No backdoors. Ever.** The codebase is the codebase.
|
||
|
||
---
|
||
|
||
## what's coming
|
||
|
||
Public release plans (the ISOs that aren't yet distributed publicly):
|
||
|
||
- **GRIMOIRE Public ISO** — the gamified training platform, signed, downloadable, with first-boot wizard, faction selection, lab progression. Target: imminent.
|
||
- **Goodlife ISO** — the AI research variant. Target: imminent.
|
||
- **Cohort programs** — multi-tenant GRIMOIRE deployments for classes, clubs, security teams.
|
||
- **Public Sigstore + Rekor** — signed releases verifiable against the public transparency log.
|
||
- **Hive expansion** — public Ansible playbook for self-hosting the 8-node Arcanum Hive.
|
||
|
||
The Operator image remains internal. That isn't a deferral. That's the design.
|
||
|
||
---
|
||
|
||
## why "Syn_OS"
|
||
|
||
Three readings, all true:
|
||
|
||
1. **The synaptic gap.** Where signal becomes meaning. Where the operating system *is* the cleft between hardware and consciousness.
|
||
2. **Synthesis.** Hardware + AI + game + mesh, fused into one platform.
|
||
3. **Sin / sanity.** A name with weight. A platform with stakes.
|
||
|
||
> *"Own your infrastructure. Own your intelligence. Own your future."*
|
||
|
||
---
|
||
|
||
## who's behind it
|
||
|
||
Built by a small team out of **LumOs Solutions**, lead by Ty Limoges in pursuit of one question:
|
||
|
||
**What if security wasn't a checklist — what if it was a way of seeing?**
|
||
|
||
The work has been sustained over multiple years, across more than sixty named version releases, with a quality bar held high enough that the project's own quality gates (cargo deny clean, 100% test pass, supply-chain provenance, binary boundary enforcement) refuse the build when they aren't met.
|
||
|
||
---
|
||
|
||
## stay close
|
||
|
||
The project is moving fast. The public ISOs are close. Watch this repository — when the chapters change, the documents change with them.
|
||
|
||
The doors open as the work matures.
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
<img src="./assets/phoenix-white.png" alt="" width="120" />
|
||
|
||
### *the gap is where the meaning lives.*
|
||
|
||
— LumOs Solutions —
|
||
|
||
</div>
|