AI Setup Guide

Groq provides one of the fastest and most capable free AI APIs available. It uses Meta's open-source Llama 3.3 70B model running on Groq's custom LPU hardware.

1. Go to console.groq.com/keys
2. Sign up for a free account (Google or email)
3. Click Create API Key
4. Copy the key — it looks like: gsk_••••••••••••••••••••

Google's Gemini 2.0 Flash is free via AI Studio and provides excellent quality for financial analysis queries.

1. Go to aistudio.google.com/apikey
2. Sign in with your Google account
3. Click Create API key
4. Copy the key — it looks like: AIzaSy••••••••••••••••••

OpenAI's GPT-4o mini is very affordable (approximately $0.15 per 1 million input tokens). Best for users who want GPT-quality responses and are comfortable with a small monthly spend.

1. Go to platform.openai.com/api-keys
2. Create an account and add a payment method
3. Click Create new secret key
4. Copy the key — it looks like: sk-proj-••••••••••••••••••••

Go to cloudflare.com and sign up. The Workers free plan gives you 100,000 requests / day — plenty for personal use.

1. From your Cloudflare Dashboard, go to Workers & Pages
2. Click Create → Worker
3. Give it a name (e.g. market-assistant)
4. Click Deploy to create the default worker

In the Worker editor, open the Edit Code view and replace the entire default code with the contents of worker.js from this project's GitHub repository.

After pasting, click Save and Deploy.

After deploying, your Worker will have a URL in the format:

Save this URL — you will paste it into the dashboard settings in Step 4.

1. Go to your Worker → Settings → Variables and Secrets
2. Click Add under Secret
3. Set the variable name based on which key you got in Step 1:

If you prefer using the command line, run one of these commands (you'll be prompted to enter the key value — it is never stored in your shell history):

On the dashboard, click the ⚙️ Settings button (top-right menu) or the 🔗 Connect AI Services link in the right sidebar. The settings panel will open.

In the ☁️ Coworker tab, paste your Worker URL into the input field:

In the Preferred AI Provider dropdown, select the provider whose key you added in Step 3. If you leave it on Auto, the Worker will try all configured providers in order.

Click 💾 Save & Connect. The status indicator will turn green and display your connected provider. You can now use the full Market Assistant, Intelligent Search, and Gamma Report features.

Yes. Your API key is stored as an encrypted secret on your Cloudflare Worker — it is never written into any code file, never committed to GitHub, and never visible in the browser. The dashboard only ever stores your Worker URL in your browser's localStorage.

No — all AI requests are routed through your personal Cloudflare Worker. The Worker holds your API key and makes the call to the AI provider on your behalf. This means your API key is never exposed in browser network requests.

The exception is if you also save a Gemini or OpenAI key directly in the Settings → Gemini / OpenAI tabs of the dashboard — those keys are stored in your browser only and are sent directly to the respective APIs as a fallback if no Worker URL is configured.

Yes. Add as many secrets to your Worker as you like (e.g. both GROQ_API_KEY and GEMINI_API_KEY). The Worker will automatically cascade — if your primary provider is rate-limited or unavailable, it tries the next one. This gives you a highly reliable AI service with zero downtime.

For most personal users, nothing. Groq and Gemini free tiers are extremely generous. The Cloudflare Workers free plan (100,000 requests / day) is also more than sufficient.

If you add OpenAI or DeepSeek keys, charges only apply when those providers are actually called. For typical personal use (a few hundred queries per day), the cost would be well under $1 / month.

Check these common issues:

• The Worker URL must not have a trailing slash
• Make sure you added the secret under Settings → Variables and Secrets → Secret (not "Plain text")
• After adding a secret, click Deploy to apply the changes
• Open the Worker URL in your browser — you should see {"status":"ok"}
• Check the Logs tab in your Worker dashboard for error messages