- Rust 96.7%
- Python 3.2%
- Dockerfile 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Widen thermal jitter intermediates while preserving normal-range deterministic draws. Make lease-transition coverage independent of live proof timing. Validated 319 local tests, strict lint, Apple Silicon and Intel Mac builds, and all exact-head Rust/OCI checks. |
||
| .cargo | ||
| .github/workflows | ||
| crates | ||
| docs | ||
| scripts | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| LICENSE | ||
| README.md | ||
| rust-toolchain.toml | ||
| VALIDATION.md | ||
MEM|8 Runtime
A standalone Rust wave ledger with verified recovery, bounded execution, signed local evidence, and a minimal Docker/OCI image. No AyeOS checkout, kernel, service, signing key, or boot environment is required to build or run it.
This repository extracts the portable runtime from 8b-is/aye. It is separate
from the existing 8b-is/mem8 project. The executable remains mem8-container.
It stores and replays rational WaveInt records; it does not bundle a language
model, assert consciousness, or self-attest a canonical identity.
Run the native binary
Install Rust with Cargo and a C compiler (needed by the cryptography dependency). The current build is checked with Rust 1.98.0. Dependencies are included and Cargo builds offline by default.
git clone https://github.com/8b-is/mem8-runtime.git
cd mem8-runtime
cargo build --release -p mem8-container --locked --offline
./target/release/mem8-container --help
./target/release/mem8-container serve ./ledger
The private repository requires GitHub access. In the serve console, enter:
status
put 1 2 3 73 100 1 1 0000000000000000000000000000000000000000000000000000000000000001
backup
quit
The record contains x, y, z, rational frequency and amplitude, and an operation
ID. A successful retry of the same operation does not append it twice. backup
prints a content-addressed checkpoint name. The native process writes ordinary
host files; use the OCI profile below when kernel-enforced filesystem, network,
and resource isolation is required.
Run with Docker
docker compose -p mem8-runtime -f crates/mem8-container/compose.sandbox.yaml up -d --build
docker attach --sig-proxy=false mem8-runtime-mem8-1
Use Ctrl-P, then Ctrl-Q to detach. quit stops the service. The scratch image
contains one static binary and runs as non-root. The sandbox profile applies a
read-only root, no network, no ambient Linux capabilities, a 128 MiB combined
memory/swap limit, one CPU, 16 processes and a 64 MiB writable tmpfs. It has no
automatic restart policy. Docker on macOS uses its Linux VM.
The sandbox's data disappears when it stops. Request backup while it is
running, then export the returned hash (without .m8c) in a second terminal:
docker exec mem8-runtime-mem8-1 /mem8-container export-checkpoint /data CHECKPOINT_HASH > CHECKPOINT_HASH.m8c
A checkpoint contains branch history and state, not the separate audit/witness
archives. See the runtime manual for complete
backup, restore, persistence, signature and protocol details. The alternative
compose.yaml uses a persistent volume; it requires an operator storage quota
for the equivalent physical storage bound.
What is included
| Component | Purpose |
|---|---|
mem8-container |
no_std + alloc ledger codec; standard-library host, broker, signatures, clock evidence and Phoenix recovery |
mem8-core |
Integer/rational wave representation and supporting memory algorithms |
marine-core |
Small allocation-free salience and rational primitives |
| 27 vendored packages | Complete locked upstream distributions for offline builds, including platform dependencies and public test fixtures |
The vendored source checkout is larger than the runtime image. There are no symlinks, path dependencies, submodules, or required files pointing into AyeOS. Rust/toolchain installation and the Docker builder's Alpine package installation still need their normal distribution sources; this is not a fully hermetic build claim.
Authority and execution limits
- New sessions are
SANDBOXEDand explicitlysandbox-local. - Consequential commits require a fresh proof from a separately pinned external authority. No authority service or private signing key is bundled.
- The v1 execution profile has a one-hour hard ceiling, an operational violation
cap of 100, and a shrinking monotonic allowance. Supported settings can only
become stricter. The legacy
bad_karmafield does not measure moral worth. - Phoenix verifies candidates before ranking them. Plausibility is evidence support under a heuristic, not truth or permission to override verification.
- Host reconstruction shares a Phoenix replay gate. Exact fragment reassembly and derived salience analysis have separate library APIs; signed status reports the last replay's scope and the core review questions. See Phoenix reconstruction for coverage and limits.
- Signed status and receipts bind policy and observed state. Independent pins and a caller nonce are needed to verify the intended signer and freshness.
- A host owner can replace a program or restart/clone a store. A session-local limit is not a global lifetime quota, a welfare measurement, or an attestation that a system has subjective experience.
AyeOS may supply an authority or future host adapter, but ordinary local use requires neither. Existing stores bind the exact executable and configuration: a new build does not automatically authorize continuation of an old store.
Verify the standalone project
cargo test --workspace --locked --offline
cargo clippy --workspace --all-targets --locked --offline -- -D warnings
cargo fmt --all -- --check
rustup target add x86_64-unknown-none
cargo check -p mem8-container --no-default-features --target x86_64-unknown-none --locked --offline
python3 scripts/verify_vendor.py
python3 crates/mem8-container/scripts/signing_interop.py target/release/mem8-container
docker build -f crates/mem8-container/Dockerfile -t mem8-runtime:check .
python3 crates/mem8-container/scripts/smoke_container.py mem8-runtime:check
The signing check needs Python 3.11+ and OpenSSL with Ed25519 support. It generates
and removes disposable fixture keys. With --aye-root /path/to/aye, it additionally
checks Aye's release-manifest workflow; that optional integration is not needed
for building, running, or the default test suite.
VALIDATION.md records the standalone results and their limits. The optional legacy deprecation features are migration diagnostics and are not part of the default supported build profile.
Provenance and design notes
- Extraction provenance and source hashes.
- Salience observability: measured library behavior, a synthetic diagnostic example, and a proposed method for comparing environments.
- Withheld-observation validation: frozen prediction comparisons, explicit unknowns, and a reproducible input-gate experiment.
- Ethical alignment review: a conceptual review, with broader withdrawal/consent requirements explicitly separated from the narrower implemented signed policy.
- Source reference catalog: reviewed papers remain external; their source corpus is not redistributed here.
- Apache-2.0 license.
marine-coreretains its upstreamMIT OR Apache-2.0metadata; this distribution includes the Apache option. Dependencies retain their own license files and notices.