WormGPT is a desktop chat client built with Electron + React and powered by the Groq API.
- Multi-chat sidebar with persistent history
- API key manager (save, test, revoke)
- Local chat storage
- Renderer bundle obfuscation (deterrent, not a guarantee)
- Optional GPU disable flag for troubleshooting
Place the screenshot at assets/screenshot.png.
- Node.js 18+ (LTS recommended)
- Windows 10/11 for installer builds
npm installnpm run startnpm run build:renderernpm run distOutputs will be in dist/.
PowerShell:
$env:WORMGPT_DISABLE_GPU='1'; npm run startOr pass a flag:
npm run start -- --disable-wormgpt-gpuDisabling hardware acceleration forces CPU rendering. Use it if you see black screens, crashes, or visual glitches caused by GPU drivers.
run-wormgpt.bat lets you choose hardware acceleration on startup and then
builds the EXE (runs npm install and npm run dist if needed), then launches
the packaged app from dist/win-unpacked or dist/.
If a build already exists, it prompts to reuse it or rebuild.
Set your API key in Settings. It is stored locally at:
%APPDATA%\\wormgpt\\wormgpt-data.json
Use the Revoke button to remove it.
- Ensure
api.txtis not present - Verify
assets/screenshot.pngis included - Remove generated artifacts before committing:
node_modules/,dist/,app/renderer/bundle.js - Run
npm installthennpm run dist - Upload EXE files from
dist/to GitHub Releases, then deletedist/again
