Brainoid Local

Brainoid Local is a native macOS, local-first AI workspace for Speech, Chat, Notes, and Agentic Extensions. This repository keeps the product source, tests, generated web bundles, immutable dependency records, patches, licences, notices, and provenance audits small enough for an ordinary source clone.

Large upstream source trees are not copied into Git. The bootstrap command fetches the seven exact, commit-pinned sources into the ignored Dependencies/upstreams/ cache, verifies their complete pristine tree hashes and licences, applies approved patch series in temporary staging, and atomically publishes only verified materializations.

Set up

Requirements are macOS 14 or later, Xcode with the Swift 6 toolchain, Git, and network access for the first dependency fetch.

./Tools/bootstrap

The first complete bootstrap downloads approximately 430 MB of upstream source. Later runs reuse the cache only after verifying it. Models, prepared runtimes, Node packages, and provider-specific assets are not downloaded by the default bootstrap.

For focused work, fetch one source:

./Tools/bootstrap --only openclaw

For a complete setup and test run:

./Tools/bootstrap --test

--test is an explicit feature trigger: it also prepares the pinned local runtime needed by the complete integration suite before running swift test. Use --repair only when an existing generated cache is intentionally being replaced after verification reports corruption or unexpected changes.

Repository layout

• Components/ contains the five production source families.
• Products/ contains thin application entry points.
• Tests/ contains product, integration, and boundary evidence.
• Tools/ contains bootstrap, dependency, build, and verification tooling.
• third_party/ contains immutable pins, hashes, patch approvals, licences, notices, and audits—but never full upstream source snapshots.
• Dependencies/ is the ignored, reproducible generated source cache.

Generated Chat, Notes, and Agentic Extensions web bundles remain tracked so ordinary Swift builds do not require Node package installation. Rebuilding those bundles is an explicit developer operation against verified fetched sources.

Third-party adoption and licence details are recorded in third_party/foundations.json and third_party/notices/.