pixel

setup guide

About 10 minutes, all free tiers. Pixel keeps your keys on a small Cloudflare Worker that you own. The app only knows the Worker's URL.

  1. Get your keys

    Required: an AssemblyAI key (hears your voice, free tier) and one AI key: Anthropic (Claude) or OpenAI (GPT).

    Optional: an ElevenLabs key for a nicer voice. Without it, Pixel speaks with the Windows voice.

  2. Make a free Cloudflare account

    Sign up at cloudflare.com. No card needed.

  3. Deploy the Worker

    Install Node.js (LTS), then in a terminal:

    git clone https://github.com/Arnav-Shrivastava/pixel
    cd pixel/worker
    npm install
    npm run setup

    The script logs you in, asks for each key, deploys, and prints your Worker URL.

  4. Install Pixel and paste the URL

    Download the installer for your computer from Releases (.exe for Windows, .dmg for Mac: arm64 for Apple Silicon, x64 for older Intel Macs). Mac: drag Pixel to Applications, then right-click it → Open → Open the first time. If it says the app is damaged, run xattr -cr /Applications/Pixel.app in Terminal. Windows: may show a SmartScreen warning because the app isn't code-signed: click More info → Run anyway. Open Pixel from the system tray (click ^ if hidden), paste the Worker URL, press Save.

  5. Allow permissions

    Windows Settings → Privacy & security → Microphone → turn on Let desktop apps access your microphone. On a Mac, allow Accessibility, Microphone and Screen Recording when asked (System Settings → Privacy & Security), then reopen Pixel. Then hold Ctrl + Alt (Ctrl + Option on Mac) and talk.

something wrong?

Open https://your-worker-url/status in a browser. It shows which keys the Worker has (yes/no only, never the keys). To add or change a key later, run npx wrangler secret put ANTHROPIC_API_KEY (or the matching name) in the worker folder. Picking a Claude model needs the Anthropic key; picking a GPT model needs the OpenAI key.