open-xdna / BCOS.md
elyanlabs's picture
Source snapshot of github.com/Scottcjn/open-xdna@6c8c680
e629bba verified
|
Raw History Blame Contribute Delete
3.18 kB
# BCOS β€” Beacon Certified Open Source
[![BCOS Certified](https://img.shields.io/badge/BCOS-Certified-brightgreen?style=flat)](https://rustchain.org/bcos/)
This repository targets certification under the **Beacon Certified Open Source
(BCOS)** program by [Elyan Labs](https://elyanlabs.ai). License: **AGPL-3.0** (+ commercial).
## Verification
```bash
python3 -m pip install clawrtc
clawrtc bcos scan .
clawrtc bcos verify BCOS-xxxxxxxx
```
Verify at: **[rustchain.org/bcos/](https://rustchain.org/bcos/)**
## What BCOS Certifies
| Check | Description | Status in this repo |
|-------|-------------|---------------------|
| License Compliance | SPDX headers + OSI-compatible deps | βœ… SPDX on **17/17** sources; `AGPLv3` LICENSE + `COMMERCIAL.md` |
| Vulnerability Scan | OSV/CVE scan | ⏳ run via `clawrtc bcos scan` |
| Static Analysis | Semgrep (3,800+ rules) | ⏳ run via `clawrtc bcos scan` |
| SBOM | Software Bill of Materials | ⏳ generated by scan |
| Dependency Freshness | % deps at latest | n/a β€” repo ships no package deps; runtime = AMD XRT/IRON/Peano (installed) + system LLVM |
| Test Evidence | test infra / self-checks | βœ… **8 self-verifying examples** (bit-exact PASS/MISMATCH) + bring-up scripts |
| Review Attestation | human/agent tier L0/L1/L2 | Scott Boudreaux (**L2, human**) |
## License boundary (important)
- **Original work** (scripts, hand-authored AIE kernels in `examples/kernels/*.cc`, docs,
benchmark harnesses): **AGPL-3.0-or-later** β€” `SPDX-License-Identifier: AGPL-3.0-or-later`
on every source. A **commercial / proprietary license** is available (`COMMERCIAL.md`) β€”
valid because this is fully-owned original work.
- **AMD's XDNA/XRT driver and IRON/mlir-aie + Peano are NOT vendored.** They are built/installed
from upstream (`amd/xdna-driver`, `Xilinx/mlir-aie`, `Xilinx/llvm-aie`), licensed separately
under **Apache-2.0 WITH LLVM-exception**. No AMD code or NPU firmware is redistributed here.
open-xdna *orchestrates* these tools; it does not derive from or embed them.
## What this repo proves (test evidence detail)
Verified on a real Ryzen 7 8845HS (XDNA1 / `RyzenAI-npu1`), Ubuntu 25.10 / kernel 6.17 / GCC 15:
- gen-1 NPU bring-up (open-source XRT + driver + firmware), DKMS-persistent
- `512Β³` int16 matmul (~68 GFLOPS) and a 2-layer MLP forward pass on the NPU
- hand-authored AIE collapse kernels (`collapse`, `collapse_rt`, `collapse_fused`), `aie::reverse`
shuffle, cross-tile reduce, and dense stream compaction β€” each with a bit-exact self-check.
## Certification Details
- **Reviewed By**: Scott Boudreaux ([@Scottcjn](https://github.com/Scottcjn))
- **Organization**: [Elyan Labs](https://elyanlabs.ai)
- **Chain**: [RustChain](https://rustchain.org) (Proof of Antiquity)
- **Engine**: BCOS v2 β€” Free & Open Source
- **On-Chain Proof**: BLAKE2b-256 commitment anchored to the RustChain ledger
β€” **pending**: run `clawrtc bcos scan .` to mint the `BCOS-xxxxxxxx` id and anchor it.
> Status: **BCOS-ready** β€” SPDX coverage, AGPLv3 LICENSE, clean upstream license boundary, and
> review attestation are in place. The on-chain certificate id is assigned when the scan runs.