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.
-
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.
-
Make a free Cloudflare account
Sign up at cloudflare.com. No card needed.
-
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 setupThe script logs you in, asks for each key, deploys, and prints your Worker URL.
-
Install Pixel and paste the URL
Download the installer for your computer from Releases (
.exefor Windows,.dmgfor Mac:arm64for Apple Silicon,x64for older Intel Macs). Mac: drag Pixel to Applications, then right-click it → Open → Open the first time. If it says the app is damaged, runxattr -cr /Applications/Pixel.appin 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. -
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.