Skip to main content

Setup Guide

Get your GenKaKu Worker up and running in 5 minutes.

Step 1: Create your account​

  1. Go to genkaku.app
  2. Click Sign In
  3. Choose one of:
    • X (Twitter) — primary login method
    • Solana wallet — Phantom, Solflare, or Backpack (click "More options")
  4. Authorize the app

Your account is created automatically on first sign-in.

Step 2: Get your Worker Token​

  1. Go to genkaku.app/settings → Worker tab
  2. Click Generate Token
  3. Copy the token — it looks like cwt_6wSa9AazKhba2Gb4VcCcDImhcVuf2eUC
  4. Save it somewhere safe — the token is only shown once
info

The cwt_ token is your worker's identity. It links your Desktop App to your GenKaKu account so earnings are credited to you.

Step 3: Download the Desktop App​

  1. Go to genkaku.app/earn
  2. Click Download for macOS (or your platform)
  3. Open the downloaded .dmg file
  4. Drag GenKaKu Worker to your Applications folder

macOS security note​

On first launch, macOS may block the app because it's from an unidentified developer:

  1. Go to System Settings → Privacy & Security
  2. Scroll down — you'll see a message about GenKaKu Worker being blocked
  3. Click Open Anyway
  4. Enter your password to confirm

Step 4: Configure your token​

  1. Open GenKaKu Worker from Applications
  2. You'll see a Worker Token Required banner at the top
  3. Paste your cwt_ token into the input field
  4. Click Save

The token is stored locally on your machine. You won't need to enter it again.

Step 5: Install Ollama (if needed)​

The Desktop App needs Ollama to run the AI model on your GPU.

  1. The app will show Ollama status in the Dashboard
  2. If Ollama is not installed, click the link to download it from ollama.com
  3. Install Ollama and restart the Desktop App
  4. Click Start in the Ollama section to launch it
tip

Ollama runs as a background service. Once started, it stays running even if you close the Desktop App.

Step 6: Connect and start earning​

  1. Click Connect & Start Earning
  2. The status changes to Connected
  3. Your GPU is now available for inference jobs
  4. Watch your earnings grow in the Dashboard

What's happening under the hood​

When you click Connect:

  1. Session registration — the app sends your token to the server, which links it to your account
  2. WebSocket connection — a persistent connection is established to the orchestrator
  3. Worker registration — your GPU's capabilities (model, speed, GPU type) are reported
  4. Job matching — the orchestrator routes jobs to your worker based on availability and performance

Token management​

Your token is stored locally using electron-store. To manage tokens:

  • View status — the Dashboard shows "Token configured" when a token is set
  • Reset token — click Reset next to the token indicator, then enter a new token
  • Revoke token — go to genkaku.app/settings → Worker tab → Revoke

You can have up to 5 active tokens per account. Each token can be used by one worker at a time.

Next steps​