Install Onhand
Until the Chrome Web Store listing is live, install Onhand as an unpacked Chromium extension from the repository.
- Clone the repository from GitHub.
- Run
npm install, thennpm run build:extension. - Open your browser's extensions page and enable developer mode.
- Choose Load unpacked and select
packages/browser-extension/. - Pin Onhand, open a normal web page, and click the extension icon to open the side panel.
Sign In Or Add A Key
Open the Onhand options page and choose one provider path:
- OpenAI Codex sign-in: recommended for normal browser tutoring.
- OpenAI API key: useful for direct API calls and the Realtime voice tutor.
If Onhand says credentials are missing, open the options page, sign in again or paste your key, save, then reopen the side panel.
Voice Tutor
Press Voice in the side panel to start the experimental realtime tutor. Your browser and macOS both need microphone access.
- If Chrome never reaches listening, check the site microphone permission and macOS Privacy & Security settings.
- If Onhand cannot create a Realtime session, confirm an OpenAI API key is saved or run the local session endpoint with
OPENAI_API_KEY=... npm run serve:realtime. - If voice works in one Chromium browser but not another, switch the microphone device in that browser and reload the extension.
PDFs And Visual Pages
Onhand works best when it can read page text directly. For PDFs, use the Onhand PDF viewer path when available. For equations, charts, and diagrams, Onhand may use a visible-region capture to ground the answer.
Report A Bug
Please open a GitHub issue with the browser, page type, what you asked Onhand to do, and any visible error message.