Watch
2
0
Fork
You've already forked 8b-is-sota
0
mirror of https://github.com/8b-is/8b-is-sota.git synced 2026-11-21 23:40:03 +01:00
SOTA.app — the 8b-is flagship: route every on-device job to the best engine (quality at speed)
  • Swift 85.8%
  • Rust 11.9%
  • Shell 2.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-27 04:56:02 +01:00
.github SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00
scripts SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00
Sources fix: apply model preferences to routing board 2026-10-09 12:12:54 +09:00
tests feat(triad): 8b-is-sota 3-AlexiAI + st AST verified triad_8b_is_sota_zero_float_step (v0-4-1739) — Why did AlexiAI-Beta love Scott Aaronson's Unitary Synthesis? Because in our Hot Tub, every wave is strictly reversible! <3 <3 2026-10-27 04:56:02 +01:00
Tests fix: apply model preferences to routing board 2026-10-09 12:12:54 +09:00
.editorconfig SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00
.gitattributes SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00
.gitignore SOTA.app — route every job to the best on-device engine 2026-10-09 06:22:18 +09:00
CHANGELOG.md fix: apply model preferences to routing board 2026-10-09 12:12:54 +09:00
CODE_OF_CONDUCT.md SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00
CONTRIBUTING.md SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00
LICENSE SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00
Package.swift Add first-install onboarding, epic settings, and app icons 2026-10-09 07:01:21 +09:00
PRIVACY.md SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00
README.md fix: apply model preferences to routing board 2026-10-09 12:12:54 +09:00
SECURITY.md SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00
TERMS.md SOTA.app v0.1.0 — appified 2026-10-09 06:30:14 +09:00

SOTA.app

the 8b-is flagship — route every on-device job to the best engine

swift platforms offline-first CI license PRs welcome semver


Table of contents

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 SOTAUI target ships OnboardingView for the first-install flow and SettingsView for everything after that.
  • The offline gate: scripts/check-offline.sh fails 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}
}