GETTING STARTED

Your first session, step by step.

A practical guide to installing B.Y.O.K, connecting your keys and getting a first answer.

1. Install B.Y.O.K

Download the latest DMG for Apple Silicon, open it and drag B.Y.O.K into Applications. Eject the disk image, then open the app from Applications.

Download 1.6.0

If macOS shows a security warning

The current development release is locally signed and not Apple-notarized. Review the source of your download and follow Apple’s instructions for safely opening apps. Your Mac may offer an app-specific approval in Privacy & Security. Managed Macs can require an administrator’s help.

2. Add your background

Open Prepare. Upload a readable PDF or plain-text résumé, or paste your background. Add the job description and relevant real examples for stronger context.

  1. Check that the imported text is readable. Image-only scans may need text recognition first.
  2. Add specific projects, actions and outcomes you can truthfully discuss.
  3. Save a preparation file or profile if you want to reuse it after quitting.

Questions and answers in the current session are not a permanent interview archive. Saving a profile stores preparation, not every answer from the session.

3. Connect a provider key

Open Connect keys. B.Y.O.K does not supply an API key. Create one with a supported provider and choose a model available to your account.

  1. Select the provider, paste its key and enter a model ID your account can use.
  2. Choose whether to remember the key in macOS Keychain. Otherwise it stays in memory for this session.
  3. Add the connection, then choose Test connection. Tests use a small sample request and consume quota.
  4. Optionally add backups, up to five total. Use the arrows to put them in priority order.

4. Load saved keys when you need them

Opening B.Y.O.K does not automatically access Keychain. In Connect keys, click Load saved keys when you’re ready. Saved connections in the shared entry load together after macOS grants access.

For keys saved by an older version, choose Import one older key. It reads one entry per click. When the needed keys are available, use Save loaded keys together once. This is separate from importing, and may need its own macOS permission.

Cancelling stops the action without automatic retries. The exact prompts are controlled by macOS; older entries can need separate authorization.

5. Enable the permissions you use

For incoming audio and spoken questions, open System Settings → Privacy & Security. Allow B.Y.O.K under:

  • Screen & System Audio Recording (the label varies by macOS version): allows incoming system audio and screen-related features.
  • Speech Recognition: converts incoming English speech to text. Apple’s service may process speech online.

Quit and reopen B.Y.O.K if macOS asks. A rebuilt app may need permission again. This build captures system audio; it does not include microphone audio in the listening stream.

6. Try your first question

  1. Open Go live, then Open live overlay.
  2. Choose Listen for incoming system audio, or type a fictional question in setup and use Answer.
  3. Use ⌘⌥Return for an answer now, or enable automatic answers after a pause.
  4. Try Shorter and More detail. Check that the answer matches your question and actual background.
  5. Stop listening when finished, and save any preparation you want to retain.

Use ⌘⌥H to show or hide the overlay. It stays interactive in version 1.6: there is no Lock setting.

Learn the live controls

Find a little help.

Type a setting or question to find its guide.