- Swift 85.8%
- Rust 11.9%
- Shell 2.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .github | ||
| scripts | ||
| Sources | ||
| tests | ||
| Tests | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| Package.swift | ||
| PRIVACY.md | ||
| README.md | ||
| SECURITY.md | ||
| TERMS.md | ||
Table of contents
- What it is
- Features
- Install
- Setup guide
- Usage
- Architecture
- Offline-first
- Security · Privacy
- Versioning
- Roadmap
- Contributing
- License · Citation
What it is
SOTA.app — the 8b-is flagship — route every on-device job to the best engine. Part of the 8b-is constellation; built to run fully on device.
Features
| 🧠 | See the module docs in Sources/ and the landing site. |
| 🔒 | Offline-first. No networking APIs anywhere in the core; enforced in CI. |
| 📱 | iOS 17+ and macOS 14+. |
| ✅ | Tests pin behaviour; swift test is the contract. |
Install
git clone https://github.com/8b-is/8b-is-sota.git
cd 8b-is-sota
swift build
swift test
Add as a dependency:
.package(url: "https://github.com/8b-is/8b-is-sota.git", from: "0.1.0")
Setup guide
Meet Onboarding on first launch: it walks you from a cold install to a working, fully on-device session in a few taps.
- Guided setup: https://setup.vaked.dev — the ELI5, illustrated walkthrough (macOS + iPhone tabs) covering Osaurus, Apple Intelligence, HuggingFace models, Shortcuts, permissions, and offline mode.
- In-app onboarding: the
SOTAUItarget shipsOnboardingViewfor the first-install flow andSettingsViewfor everything after that. - The offline gate:
scripts/check-offline.shfails CI if the core ever reaches for the network. Privacy is a compile-time property here.
Usage
import SOTACore
let route = Router().route(.infer, preferredEngineID: "project-zero")
In SettingsView, model overrides update the board for that capability. New
preferences default to Auto, which chooses the highest-scoring eligible
engine. An override still obeys the on-device and latency limits. If the selected
engine is unavailable or excluded, routing falls back to Auto; if no engine is
eligible, it returns no route. Existing saved selections are preserved.
Architecture
8b-is-sota/
├── Package.swift
├── Sources/SOTACore/ # the library (offline-first core)
├── Tests/ # swift test
├── scripts/check-offline.sh# the offline-first gate (runs in CI)
└── .github/ # templates, CODEOWNERS, CI
Offline-first
SOTA.app must work with the network off. The gate scripts/check-offline.sh scans
Sources/ for networking APIs (URLSession, URLRequest, NWConnection,
import Network) and fails the build if any appear. Privacy is not a setting;
it is a compile-time property. See PRIVACY.md.
Security
See SECURITY.md for how to report a vulnerability. Do not open a public issue for security problems.
Privacy
See PRIVACY.md. In one line: your data never leaves the device.
Versioning
Semantic Versioning. The current version is 0.1.0 — see
CHANGELOG.md. Releases are tagged v0.1.0.
Roadmap
See the issues and the CHANGELOG.
Contributing
See CONTRIBUTING.md and the Code of Conduct. Small, tested PRs are the fastest path.
License
Apache-2.0 © the 8b-is constellation.
Citation
@software{8b-is-sota,
title = {SOTA.app},
author = {8b-is},
year = {2026},
url = {https://github.com/8b-is/8b-is-sota}
}