Skip to content

fix: add macOS camera permission warning and docs for Sequoia users#2418

Open
Wanbogang wants to merge 5 commits intoOpenMind:mainfrom
Wanbogang:fix/macos-camera-permission-docs
Open

fix: add macOS camera permission warning and docs for Sequoia users#2418
Wanbogang wants to merge 5 commits intoOpenMind:mainfrom
Wanbogang:fix/macos-camera-permission-docs

Conversation

@Wanbogang
Copy link
Collaborator

Fixes #1176

This PR addresses missing camera permission guidance for macOS Sequoia users. On macOS Sequoia and later, camera access must be explicitly granted to the terminal application before running any OM1 agent that uses camera input. Without this, OM1 runs normally but receives no camera input — with no clear error message to indicate why.

Changes

Documentation

  • docs/robotics/mac.md — Added a new section explaining how to grant camera permission on macOS Sequoia
  • docs/developing/1_get-started.md — Added a macOS callout note in Step 3 (Run the Spot Agent) linking to the mac.md guide

Code

  • src/inputs/plugins/vlm_coco_local.py — Upgraded logging.info to logging.warning with actionable macOS permission guidance
  • src/inputs/plugins/webcam_to_face_emotion.py — Upgraded logging.info to logging.warning with actionable macOS permission guidance
  • src/inputs/plugins/vlm_local_yolo.py — Added macOS permission guidance to existing logging.error message

@Wanbogang Wanbogang requested review from a team as code owners February 24, 2026 12:09
@github-actions github-actions bot added documentation Improvements or additions to documentation robotics Robotics code changes python Python code labels Feb 24, 2026
@codecov
Copy link

codecov bot commented Feb 24, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

@Wanbogang Wanbogang requested a review from a team as a code owner February 24, 2026 18:41
@github-actions github-actions bot added the tests Test files label Feb 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation python Python code robotics Robotics code changes tests Test files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

macOS: Camera permission requirement missing in Getting Started guide

1 participant