Speak naturally. Build precisely.
Turn rough Hindi, English, or Hinglish ideas into clear prompts your coding agent can act on.
PromptDe is a local voice-to-prompt utility for developers. Say a task the way it comes to you—even if you mix Hindi and English—and PromptDe turns it into a structured English prompt ready for a coding agent.
For example:
You say: “Login page mein forgot password add karna hai. Existing design use karo.”
PromptDe produces: “Add a forgot-password flow to the existing login page. Reuse the current design system and preserve the page's established visual patterns.”
You can also translate speech, rewrite selected text, and paste the result directly into the application you are using. Prefer typing? The same workflow works without a microphone.
- Speak or type your idea in Hindi, English, or Hinglish.
- Transcribe speech with Groq Whisper.
- Choose the result: translate the text, or compile it into a Quick, Standard, or Detailed prompt with Groq or Gemini.
- Copy or paste the result into your coding agent, editor, browser, or any other app.
- Keep your train of thought: describe a task faster than you can format it.
- Speak naturally: mixed Hindi and English are welcome.
- Give agents better context: add project details and choose how much structure the prompt needs.
- Work across applications: desktop shortcuts can process speech or selected text and paste the result at your cursor.
- Bring your own keys: use your own Groq and optional Gemini API keys.
- Stay local by default: the interface and server run on your machine; only provider requests are sent to the selected AI service.
| Mode | Best for | Result |
|---|---|---|
| Quick | Small, obvious changes | A short, direct instruction |
| Standard | Most coding tasks | A clear goal, context, and expected outcome |
| Detailed | Complex or risky work | Requirements, constraints, steps, and acceptance checks |
The desktop app includes everything needed to run PromptDe. You do not need Node.js, npm, or Git unless you install from source.
For 64-bit Intel/AMD Linux:
curl -fsSL https://github.com/ITISH7/PromptDe/releases/latest/download/install-promptde-linux.sh | shThe installer downloads the latest AppImage, adds PromptDe to your application menu, and checks the shortcut helpers required by your X11 or Wayland session. Installing missing system packages may ask for administrator access.
Set PROMPTDE_SKIP_SYSTEM_DEPENDENCIES=1 before running the installer only if you manage those packages yourself.
Download PromptDe for Windows (Windows 10 or newer, 64-bit), then open the installer.
The per-user installer does not require administrator access. Current Windows builds may be unsigned, so your browser or Windows SmartScreen can show a warning:
- If the browser warns that the download is not commonly downloaded, choose Keep.
- If Windows SmartScreen shows “Windows protected your PC,” choose More info, then Run anyway.
Optional PowerShell installer
$script = "$env:TEMP\install-promptde.ps1"
Invoke-WebRequest -UseBasicParsing https://raw.githubusercontent.com/ITISH7/PromptDe/HEAD/scripts/install-desktop.ps1 -OutFile $script
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $script- Apple Silicon (M1 and newer)
- Intel Mac
Open the DMG and drag PromptDe into Applications. Current Mac builds are not notarized, so the first launch may require you to Control-click the app, choose Open, and confirm.
If macOS blocks PromptDe or reports that the app cannot be opened, remove the quarantine attribute and launch the installed application:
xattr -dr com.apple.quarantine /Applications/PromptDe.app
open /Applications/PromptDe.appIf desktop shortcuts cannot copy selected text or paste generated text, enable both permissions and then quit and reopen PromptDe:
- System Settings → Privacy & Security → Accessibility → PromptDe
- System Settings → Privacy & Security → Automation → PromptDe → System Events
You need Node.js 22.12 or newer and a Groq API key.
git clone https://github.com/ITISH7/PromptDe.git
cd PromptDe
npm ci
cp .env.example .env
npm startAdd your key to .env:
GROQ_API_KEY=gsk_your_groq_api_key_here
GEMINI_API_KEY=your_optional_gemini_api_key_here
PORT=4173Then open http://127.0.0.1:4173. To run the Electron desktop app instead, use npm run desktop.
On Debian/Ubuntu, install the helpers for your display server if you want system-wide paste shortcuts:
# X11
sudo apt install xdotool x11-utils
# Wayland
sudo apt install wtype xdg-desktop-portalIf a compositor blocks automatic paste, PromptDe leaves the generated text on your clipboard.
- Open Settings and add a Groq API key. Groq is required for voice transcription and is the default prompt compiler.
- Optionally add a Gemini API key and select Gemini as the compiler.
- Choose a language or leave language detection on Auto.
- Speak or type an idea, add optional project context, and choose a prompt mode.
- Select Compile my prompt, review the result, and copy it to your agent.
You can get a Groq API key and, if wanted, a Gemini API key.
Desktop shortcuts work while PromptDe is running. Press a recording shortcut once to start and again to stop and process the recording.
| Action | Windows/Linux | macOS |
|---|---|---|
| Show, record, and compile | Ctrl+Shift+Space |
Cmd+Shift+Space |
| Clear the transcript | Ctrl+Shift+Backspace |
Cmd+Shift+Backspace |
| Record project context | Ctrl+Alt+C |
Cmd+Option+C |
| Copy the English interpretation | Ctrl+Alt+E |
Cmd+Option+E |
| Copy the compiled prompt | Ctrl+Alt+P |
Cmd+Option+P |
| Record, translate, and paste | Ctrl+F9 |
Cmd+F9 |
| Record a Quick prompt and paste | Shift+F1 |
Shift+F1 |
| Record a Standard prompt and paste | Shift+F2 |
Shift+F2 |
| Record a Detailed prompt and paste | Shift+F3 |
Shift+F3 |
| Translate selected text to English | Ctrl+Shift+F5 |
Cmd+Shift+F5 |
| Selected text → Quick prompt | Ctrl+Shift+F6 |
Cmd+Shift+F6 |
| Selected text → Standard prompt | Ctrl+Shift+F7 |
Cmd+Shift+F7 |
| Selected text → Detailed prompt | Ctrl+Shift+F8 |
Cmd+Shift+F8 |
Shortcut values can be changed with the PROMPTDE_*_SHORTCUT variables shown in .env.example.
- Web app: keys entered in Settings live only in browser session storage and are cleared when the tab closes. The server does not persist them.
- Desktop app: keys are stored in PromptDe's local configuration
.env. Use Settings → Open configuration folder to find it. - Provider calls: audio is sent to Groq for transcription. Prompt text is sent to the compiler you select—Groq or Gemini.
- Repository safety:
.envfiles are ignored by Git. Never commit real credentials.
If both compiler keys are configured, PromptDe can fall back to the other provider after a temporary compiler error.
PromptDe uses Node.js ES modules, the built-in HTTP server, plain HTML/CSS/JavaScript, and Electron.
npm ci # install exact dependencies
npm run lint # validate server, browser, desktop, and test code
npm test # run integration tests without making provider API calls
npm run desktop # launch the desktop app in development modeBuild desktop packages
npm run pack:linux
npm run pack:windows
npm run pack:windows:portable
npm run pack:macLinux builds produce AppImage and Debian packages. Windows builds produce an NSIS installer or portable ZIP. macOS builds must run on macOS and produce Intel and Apple Silicon DMGs. Output is written to dist/.
.
├── desktop/ Electron main process, launcher, and preload bridge
├── public/ Browser interface
├── docs/images/ README screenshots and diagrams
├── scripts/ Install and packaging helpers
├── test/ Node integration tests
├── server.mjs Local HTTP server and provider integrations
└── package.json npm scripts and desktop packaging configuration
Contributions are welcome. Read CONTRIBUTING.md for setup and pull-request guidance, and follow the Code of Conduct.
- Report bugs or request features with the GitHub issue forms.
- Report vulnerabilities privately using the security policy.
- See planned work in the roadmap and released changes in the changelog.
- For installation help, start with the support guide.
PromptDe is available under the MIT License.