๐Ÿ“– Setup Guide ยท v8.8

Get started in 5 minutes

Step-by-step guides to set up your API keys and integrations. Everything is free to start โ€” no credit card required.

โšก

Groq API Key

Llama 3.3 70B ยท Fastest response ยท Recommended for new users

Free Forever โ˜… Recommended โ–พ
๐Ÿ’ก Why Groq? Groq is the fastest AI in the world โ€” 30 requests/minute, 14,400 requests/day, completely free. No credit card ever. Perfect for generating test cases all day.

Open Groq Console

Go to the Groq API key management page in your browser.

๐Ÿ”— console.groq.com/keys

Sign in with Google

Click "Sign in" โ†’ choose "Continue with Google" โ†’ select your Google account. No form filling needed โ€” just one click.

Create a new API key

Once logged in, click the "Create API Key" button (blue button, top right of the page).

Give it a name like "Shuddhi QA" โ†’ click "Submit".

Copy the key

Your key appears once โ€” it starts with gsk_. Click the copy icon next to it.

gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
โš ๏ธSave this key somewhere safe โ€” Groq only shows it once. If you lose it, just create a new one (it's free).

Paste it in Shuddhi QA

Open Shuddhi QA โ†’ Settings (โš™๏ธ) โ†’ AI Provider. Under "Your Personal API Keys", find the Groq row and paste your key. Click ๐Ÿ”Œ Test to verify it works. Done!

โœฆ

Google Gemini API Key

Gemini 2.5 Flash ยท Best quality output ยท 15 req/min free

Free Tier โ–พ
๐Ÿ’ก Why Gemini? Gemini 2.5 Flash produces the highest quality test cases of the three free options. Best for large, complex D365 or Salesforce requirement documents.

Open Google AI Studio

Go to Google AI Studio โ€” the official portal to create Gemini API keys.

๐Ÿ”— aistudio.google.com/app/apikey

Sign in with Google

Sign in with any Google account โ€” the same one you use for Gmail or Google Drive is fine.

Create API key

Click "Create API key" โ†’ Select "Create API key in new project" (easiest option). Google creates a project automatically.

Copy the key

Your key appears โ€” it starts with AIzaSy. Click the copy icon.

AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Paste it in Shuddhi QA

Open Settings โ†’ AI Provider โ†’ Your Personal API Keys โ†’ Gemini row. Paste the key and click ๐Ÿ”Œ Test.

Free tier limits: 15 requests/minute ยท 1,500 requests/day ยท 1 million tokens/minute. More than enough for daily QA work.
๐Ÿค–

Anthropic Claude API Key

Claude Sonnet 4.6 ยท Highest QA reasoning quality ยท Paid

Paid โ€” ~$0.10/run โ–พ
๐Ÿ’ก Why Claude? Claude produces the most accurate, detailed test cases for complex enterprise workflows (D365, Salesforce, SAP). Recommended if you need the highest quality output. Cost: ~โ‚น9 per generation.

Open Anthropic Console

๐Ÿ”— console.anthropic.com

Create an account

Click "Sign up" โ†’ enter your email โ†’ verify โ†’ set a password.

Add a payment method

Claude requires a credit/debit card to activate the API (even for pay-as-you-go at very low rates). Go to Settings โ†’ Billing โ†’ Add payment method.

๐Ÿ’ฐRecommended: add $5 credits to start. At ~$0.10/generation, that's 50 generations โ€” more than enough to evaluate quality before committing.

Create API key

Go to Settings โ†’ API Keys โ†’ Create Key. Name it "Shuddhi QA" โ†’ click Create.

Copy the key

sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
โš ๏ธClaude keys are shown only once. Copy it immediately and save it.

Paste it in Shuddhi QA

Open Settings โ†’ AI Provider โ†’ Your Personal API Keys โ†’ Claude row. Paste the key and click ๐Ÿ”Œ Test.

๐Ÿ”ท

Azure DevOps โ€” Personal Access Token (PAT)

Required to push test cases to ADO Test Plans and fetch Work Items

Free with ADO account โ–พ
A Personal Access Token (PAT) is like a password that lets Shuddhi QA talk to Azure DevOps on your behalf. It is stored only in your browser โ€” never on Shuddhi QA servers.

Open Azure DevOps

Go to your Azure DevOps organisation. The URL looks like:

https://dev.azure.com/YOUR-ORGANISATION

If you don't have one, create a free account at:

๐Ÿ”— dev.azure.com

Open User Settings

Click your profile picture (top right corner) โ†’ select "Personal access tokens" from the dropdown menu.

Create a new token

Click "+ New Token" (blue button, top right). Fill in the details:

FieldWhat to enter
NameShuddhi QA
OrganisationAll accessible organisations
Expiration90 days (or custom โ€” longer is more convenient)

Set the required scopes

Under "Scopes", click "Custom defined" and enable these specific permissions:

ScopePermissionRequired for
Test Managementโœ“ Read & WritePush test cases to Test Plans
Work Itemsโœ“ Read & WriteFetch Work Items for auto-fill
Project and Teamโœ“ ReadList projects in your org
๐Ÿ’กIf you only need to fetch Work Items (not push test cases), enabling Work Items Read is sufficient. You can always recreate the token with more permissions later.

Copy the token

Click "Create". Copy the token immediately โ€” ADO shows it only once.

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
โš ๏ธSave the token in a password manager or secure note. If you lose it, you'll need to create a new one (the old one cannot be recovered).

Configure in Shuddhi QA

Open Settings โ†’ Azure DevOps tab. Fill in:

FieldExample value
Organisation URLhttps://dev.azure.com/mycompany
Personal Access TokenPaste your token here
Default ProjectMyProject (optional)

Click "Test Connection" โ†’ should show โœ… Connected.

๐ŸŸฆ

Jira โ€” API Token

Required to fetch Jira tickets and auto-fill requirement flow

Free with Jira account โ–พ
A Jira API token lets Shuddhi QA read your Jira tickets. When you enter a ticket ID like PROJ-1234, Shuddhi QA fetches the summary, description, and acceptance criteria to automatically fill your requirement flow.

Open Atlassian Account Settings

Go directly to the API token management page:

๐Ÿ”— id.atlassian.com โ†’ Security โ†’ API tokens

Sign in to Atlassian

Sign in with the same account you use for Jira at work. This is typically your work email address.

Create API token

Click "Create API token" โ†’ Enter a label like "Shuddhi QA" โ†’ click "Create".

Copy the token

The token is displayed once. Click "Copy" immediately.

ATATT3xFfGF0xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
โš ๏ธYou will not be able to view the token again. If you lose it, create a new one (the old one will be revoked).

Find your Jira Base URL

Your Jira Base URL is the address you use to access Jira in your browser:

https://yourcompany.atlassian.net

Do NOT include the project path โ€” just the base domain.

Configure in Shuddhi QA

Open Settings โ†’ Jira tab. Fill in:

FieldExample value
Jira Base URLhttps://yourcompany.atlassian.net
Emailramya@yourcompany.com (your Atlassian login email)
API TokenPaste the token you just copied

Click "Test Connection" โ†’ should show โœ… Connected as [your name].

๐Ÿ’กNow you can enter any Jira ticket ID (e.g. ERP-567) in the main screen and click Fetch โ†’ to auto-fill the requirement flow in seconds.
๐Ÿš€

Generate Your First Test Cases

From zero to 40+ test cases in under 60 seconds

Quick Start โ–พ

Add your API key (one-time setup)

Click โš™๏ธ Settings โ†’ AI Provider โ†’ Your Personal API Keys. Paste your Groq key in the Groq row. Click ๐Ÿ”Œ Test to verify. Done โ€” this is saved in your browser permanently.

Choose your platform

In the left panel, click your platform: D365 F&O, Salesforce, Web App, Mobile, etc. Shuddhi QA tailors the test cases to the platform you choose.

Describe the business flow

In the right panel under "Describe the Business Flow", type a plain-English description of the process you want to test. Example:

Vendor submits invoice via portal. AP Clerk performs 3-way match (Invoice, PO, Goods Receipt). If amount > โ‚น50,000, Finance Manager approves via workflow. Payment is scheduled and GL journal is posted.

You can also upload a PDF/DOCX requirement document โ€” Shuddhi QA reads it automatically.

Or fetch from Jira / ADO

If you have Jira or ADO configured, enter the ticket ID in the Jira Ticket ID or ADO Work Item ID field and click Fetch โ†’. The description auto-fills instantly.

Set output options

OptionChoices
Test PriorityHigh (focus on critical paths) ยท Medium ยท Low (comprehensive)
Output FormatEnd to End ยท Smoke ยท Integration ยท Full Suite
LanguageEnglish, Telugu, Hindi, Tamil, and 5 more

Click Generate

Click the โšก Generate Test Cases button (or press Ctrl+Enter). Shuddhi QA generates 30โ€“70 test cases with test steps, expected results, and priority in about 15โ€“30 seconds.

Export or push

Once generated, use the export buttons:

ButtonWhat it does
ExcelDownloads .xlsx with separate sheets per TC type
PDFFormatted PDF document ready to share
MarkdownCopies to clipboard for Confluence/Notion
ADO buttonPushes directly to Azure DevOps Test Plan
More โ–พJira Zephyr CSV, TestRail, Gherkin, Playwright, Postman