How to set up your Blob

About five minutes. All you need is Guppy v1.1.106 on Windows, a microphone and a free Groq account of your own.

  1. 1 Get a free Groq API key

    The Blob turns speech into text with Groq. Create a free account at console.groq.com, open API Keys and create a key. Copy it: it starts with gsk_.

    The key is yours. Guppy keeps it in its local settings on your PC and sends it only to Groq.

  2. 2 Recommended: turn on Zero Data Retention

    In the Groq console, open the Data Controls settings page and turn on Zero Data Retention. Groq then keeps none of your audio or transcripts, not even the short-lived logs it otherwise may keep for troubleshooting and abuse checks. Details: Your Data in GroqCloud.

  3. 3 Paste the key into Guppy

    In Guppy, open Settings > Voice. Under Free Flow, switch Free Flow (voice dictation) to on; the Groq API key field appears. Paste your key and click save.

  4. 4 Turn on the Blob and dictation

    Open Settings > General > Blob and switch on:

    • Show the Blob: the face appears on top of your other windows. Drag it wherever you like.
    • Dictation: hold Ctrl+Alt+Space to talk. The status line next to it should read Ready.

    The hold-to-talk keys are always Ctrl+Alt+Space. The separate Show/hide hotkey is Ctrl+Alt+G by default; you can change it there or leave it blank. Hide the blob from screen shares is on by default.

  5. 5 Try it

    Open Notepad (or any app with a text field) and click into it. Hold Ctrl+Alt+Space, say Hello from my Guppy Blob, then let go. The Blob shows it is listening, then transcribing, and the sentence is typed where your cursor was. It never presses Enter.

    Clips can be 0.3 s to 120 s long. If you switch to another window before the text arrives, nothing is typed and the Blob tells you.

  6. 6 If it doesn’t work

    • Status says Unavailable: “Dictation needs a Groq API key”. Go back to step 3, paste the key and click save.
    • “Microphone permission denied” or “could not open microphone”. In Windows Settings > Privacy & security > Microphone, allow microphone access and access for desktop apps, and check a microphone is plugged in.
    • The key is rejected (Groq answers that the API key is invalid). Create a new key in the Groq console, paste it in step 3 and save again.
    • “Dictation needs the Guppy window open”. Guppy records the microphone through its own window, so keep Guppy running.
    • “The Ctrl+Alt+Space hook could not be armed”. Switch dictation off and on again in Settings > General > Blob, or restart Guppy.
    • “No speech detected; nothing was typed.” Hold the keys a moment longer and speak while holding them.
  7. 7 Privacy

    When you use Blob dictation, the audio you record goes to Groq for speech-to-text, under your own Groq account and key, and the transcript comes back to be typed. Groq’s terms and your Data Controls settings apply. Blob dictation records only while you hold the keys.

Back to the Blob on the home page · What the Blob does in v1.1.106