BlindAssist is an Android showcase research prototype for goal-driven visual assistance. It combines camera perception, risk logic, and concise guidance to demonstrate measurable effects in clearly stated controlled conditions. It is not a certified mobility or safety product.

Start here

• Current project state: docs/PROJECT_STATE.md
• Current research decision: docs/CURRENT_DECISION.md
• L10-R0 current: research/active/l10-r0/CURRENT.md
• DTR-R2 current: research/active/dtr-r0/CURRENT.md
• Code ownership: docs/CODE_MAP.md
• Documentation map: docs/README.md
• Historical lookup: docs/history-index.md

Two tracked research routes are operational in the current branch. Closed experiments are summarized in experiments/index.jsonl and remain recoverable from the remote tag archive/pre-agent-surface-2026-08-26 or the terminal commits listed in docs/history-index.md.

Workstation profiles

Copy the local template once and edit only machine-owned values:

Copy-Item config/local.example.toml config/local.toml
pwsh -NoProfile -File tools/ba.ps1 setup base
pwsh -NoProfile -File tools/ba.ps1 doctor base

Profiles are independent: base, research-l10-r0, research-dtr-r0, android, device, and export. Research setup does not install or probe Android tooling.

pwsh -NoProfile -File tools/ba.ps1 setup research-dtr-r0
pwsh -NoProfile -File tools/ba.ps1 doctor research-dtr-r0
pwsh -NoProfile -File tools/ba.ps1 smoke research-dtr-r0

The Codex desktop environment exposes the same setup and common actions through .codex/environments/environment.toml.

Android

Run Gradle only through the repository wrapper:

pwsh -NoProfile -File scripts/run_android_gradle.ps1 :app:assembleDebug

Module boundaries are stable: :app owns the shell and assets, :feature:assist runtime coordination, :core:assist pure risk logic, :core:vision detection, :core:device Android adapters, and :core:ui state and rendering.

Evidence boundary

Synthetic, replay, curated Development, device, and natural evidence are named separately. UNKNOWN and NOT_EVALUABLE are not negative evidence. A focused demo result is never presented as universal real-world or safety performance. Protected final evaluations use formal research governance.

License

See CONTRIBUTING.md, GOVERNANCE.md, the model card, maintainer automation, the threat model, LICENSE, THIRD_PARTY_NOTICES.md, and SECURITY.md.