Install Groking

Install on your computer. Your folders, your Grok account. With a license key, activation is automatic.

● Private to your machine · nothing shared

System requirements

1

Run the installer

Paste this into Terminal. Sets up Groking and opens it (~1 minute).

curl -fsSL https://grok.imagineqira.com/install.sh | bash

Requires Python 3.10+. Installs the free Grok CLI if missing. On macOS it builds Groking.app.

★

Have a license key? Install + activate in one line

Replace the key (or copy the personalized command from your purchase success page).

GROKING_LICENSE_KEY='GROK-XXXX-XXXX-XXXX' curl -fsSL https://grok.imagineqira.com/install.sh | bash

After purchase, the success page embeds your real key so you never re-type it.

1

Run the installer in PowerShell

Open PowerShell and paste this. Installs to ~/Groking, adds a Start Menu shortcut, and opens the app.

irm https://grok.imagineqira.com/install.ps1 | iex

Requires Windows 10+ with Python 3.10+ on PATH (python.org — check “Add python.exe to PATH”). Installs the free Grok CLI if needed.

★

Have a license key? Install + activate in one line

$env:GROKING_LICENSE_KEY='GROK-XXXX-XXXX-XXXX'; irm https://grok.imagineqira.com/install.ps1 | iex

Your purchase success page includes this with your real key filled in.

2

If you installed without a key

When Groking opens, paste your GROK-… key once. It unlocks this machine and then works offline (with weekly re-check when online).

GROK-XXXX-XXXX-XXXX

No key yet? Get Groking. Missing email? Check spam, or contact support.

3

Launch next time

Tips: Grok not found? Run grok login --device-auth then reopen Groking. Re-running the installer upgrades in place and keeps your activation. On a machine that already hosts the public license server, the installer auto-picks ~/Groking-app so it never overwrites that install.

If something fails — step by step

Follow the matching section. Do the steps in order.

Installer command fails / curl error / network
  1. Confirm you are online. Retry the same command once.
  2. macOS/Linux: use Terminal. Windows: use PowerShell (not Command Prompt).
  3. If corporate VPN blocks downloads, disconnect VPN or try another network.
  4. Manual fallback: download .tar.gz or .zip, extract to ~/Groking, then run start.sh / start.ps1.
  5. Still stuck? Email support with your OS and the exact error line.
Python not found / wrong version
  1. Install Python 3.10+ from python.org.
  2. Windows: check Add python.exe to PATH, then close and reopen PowerShell.
  3. Verify: python3 --version (or python --version on Windows) shows 3.10 or newer.
  4. Re-run the one-line installer from the top of this page.
Install finished but Groking will not open
  1. macOS: open ~/Groking/Groking.app (or ~/Groking-app if that path was used).
  2. Windows: Start Menu → Groking, or run start.ps1 in %USERPROFILE%\Groking.
  3. Linux: run ~/Groking/start.sh.
  4. Then open http://127.0.0.1:8899/app in your browser.
  5. If the page never loads, wait 30 seconds and refresh once. Re-run the installer to repair.
Login / license key rejected
  1. Use the License key field on your install (not someone else’s public owner site).
  2. Key must start with GROK- — paste from purchase email or success page with no spaces.
  3. Seats full? Free a seat from another machine, then unlock again.
  4. Owner Mac passphrase is different: only for the machine that has ~/groking/.auth-passphrase.
  5. Missing email? Check spam, then contact support.
Grok CLI missing or not logged in
  1. Re-run the Groking installer (it can install the free Grok CLI).
  2. In Terminal: grok --version — if “not found”, fix PATH and reopen the app.
  3. Sign in: in the app click Connect Grok, or run grok login --device-auth.
  4. Confirm the on-screen code, then return to Groking — status should turn green.
  5. Grok/xAI account is separate from your Groking license.
App opens but “out of turns” / cannot send tasks
  1. Free plan includes a monthly turn allowance. Check the Credits chip in the app.
  2. Buy a credit pack or upgrade at pricing for unlimited (Pro / Team / Lifetime).
  3. Hard-refresh the workspace after purchase so entitlements reload.
  4. Still blocked with a paid plan? Email support with the last 4 characters of your key.
Multi-session: you can run several projects at once — each has its own process and timeline. Prefer one active writer per folder. When calling Cloudflare-fronted APIs from Python, set a User-Agent (bare urllib gets CF error 1010).

Don't have a license yet? Get Groking →
Manual packages: .tar.gz · .zip · Troubleshooting