GrowthKit AI

1Overview

GrowthKit AI puts lead finding and WhatsApp messaging on your Windows PC. To start, make a license key for your computer with the included Key Generator and enter it in the app.

2Package contents

3Requirements

• Windows 10 or 11, 64-bit, with about 300 MB of free disk space.
• An internet connection.
• A WhatsApp number on a phone, to link to the app.
• For the AI features only: a free Google Gemini API key (see Settings).

4Installation

1. Run GrowthKitAI-Setup-2.0.exe. If Windows shows Windows protected your PC, click More info, then Run anyway, and accept the permission prompt.

2. Choose the setup language (English or Arabic) and click OK.

1. Keep the default folder C:\Program Files\GrowthKit AI and click Next.
2. Keep Create a desktop shortcut ticked and click Next.

1. Click Install and wait until the files are copied.
2. Click Finish. The app opens on the activation screen.

5Activation

Each license works on one computer. The key is made for that computer's Machine ID.

1. Open the app. Copy Your Machine ID with the copy button 1.
2. Make the key with the Key Generator. Paste it in Enter License Key 2.
3. Click Activate Now 3.

6Key Generator

1. Install GrowthKitKeyGen-Setup-2.0.exe and open it.
2. Enter your details 1: your name or business and your phone or email. They are optional, and they appear in License Details inside the app.
3. Paste your Machine ID 2. You find it on the app's activation screen (see Activation). It must be 16 characters.
4. Set the duration in days, hours and minutes 3, or tick Lifetime license (never expires) 4.

1. Under Package Features, tick the tools you want to use, or All tools.

1. Click GENERATE LICENSE, copy the key (it starts with GK2.) and paste it into the app's activation screen.

7Dashboard

The menu on the left opens every tool. The dashboard shows the available tools; click a card to open it.

8WhatsApp accounts

Every WhatsApp tool needs a linked account. You can link several; each has its own browser profile.

1. Open Account Management and click Add New Account 1.
2. Enter a name (for example: Marketing) and choose how to link it:
   • QR Code: on the phone open WhatsApp → Linked devices → Link a device and scan the code.
   • Phone Link (Code): enter the number with its country code, digits only. An 8-character code appears; on the phone choose Link with phone number instead and type it.
   • External Browser: opens a visible browser window where you scan the code yourself.
3. Wait for the success message. Linking stops after 5 minutes; you can try again.

9Message Templates

1. Open Message Templates and click Create New Template.
2. Enter a name, a category and the message. Click a variable chip to insert it at the cursor; the preview shows the message for a sample contact.
3. Save. In the Individual Sender, pick the template from Apply Message Template.

10Contact Groups

Groups are the phone lists used by the Sender and the Filter. Every tool that finds numbers can save them as a group.

1. Open Contact Groups, click Create New Group and enter a name and description.
2. Open the group and add members with Add Member, or Import from Excel (xlsx, xls or csv). The import shows a preview where you can pick the phone and name columns.

11Individual Sender

Sends a message to every number in the list, one by one, with random gaps between messages.

Step 1: the message

1. Pick a saved template 1, or write the message 6.
2. Insert variables from the toolbar 2: Random, Name, Phone, Spoiler and Key Marker (see Variables).
3. Add attachments 3: Poll, Media (image, video, file, sticker, voice note), Location, Contact or Event. They are sent with every message.
4. Optional: AI Generate 4 writes several versions of your message, and 5 adds or removes a version tab. Versions are sent in turn: the first number gets version 1, the second version 2, and so on.

Step 2: the numbers

1. Choose a saved group in Select Target Group, or use Upload Excel File or Paste Numbers. Download Sample gives an example Excel file; any extra column can be used as a variable.
2. For local numbers, type the country code and click Add Code. Remove Duplicates cleans the list.

Step 3: settings and launch

1. Click Settings 1 and choose the account.
2. Click Start 3. Stop 2 stops at once, even during a wait. Progress appears in the console 4 and each number's status in the table.

At the end, a message shows how many were sent, failed and skipped; export the table with Export Excel. If you run the same list again, the app asks whether to skip the numbers that already got the message.

12WhatsApp Number Filter

Shows which numbers have WhatsApp, and which are business accounts, before you send.

1. Choose the account. Type or paste the numbers (one per line), or load them from a file or a group.
2. Click Start Checking. The counters show Available, Not Available, Business, Regular and Unknown.
3. Export with Export Excel, or keep the valid numbers with Save Selected to Contact Group.

Safe Mode Settings: after every batch of numbers 2 (default 100), the app pauses for a random time between Min and Max seconds 1 (default 1–10 s). Numbers must be in international form, with the country code.

Generate Numbers makes a list in sequence from a country code, a starting number, a quantity and a step.

13Grab Chat List

1. Choose the account and click Fetch Chat List.
2. All chats appear with their type: person, group, channel or broadcast list.
3. Use Export to Excel, or Save Selected to Contact Group.

14WhatsApp Label Extractor

For WhatsApp Business accounts that use labels such as "New customer" or "Paid".

1. Choose the account and click Fetch Labels.
2. Each label appears with its chats. A chat with two labels appears under both.
3. Export a label to Excel, or save it as a contact group.

15Google Maps Data Extractor

1. Write one search per line 1, for example Restaurants in Dubai.
2. Choose the options 2–4 (table below) and click START PROCESS 5.

Each place has its name, category, phone, address, website, rating, number of reviews, Maps link and coordinates (and email if chosen). Results are also saved while the app works to Documents\GrowthKit AI\Results as a CSV file.

16Variables

Variables work in the Individual Sender and in Message Templates. Upper and lower case are the same.

Example: {{KEY: Hi | Hello}} {Name}, today's offer ends at {Time}!

17Settings and license

License Details shows the license owner, the seller, the dates, the enabled tools and the version.

18Logo, colors and languages

There are two ways to make the app your own. Change the name and logo from Settings, with no code and no rebuild. Or change the logo, colors, themes and texts in the source code, then rebuild the installers.

Name and logo from Settings (no code)

Logo, icon and name in the source code

The paths below are inside Source_Code\GrowthKit_AI.

Colors and themes

The app has 12 themes; the user picks one in Settings → Theme. Each theme is a set of colors in ui\themes.py:

Colors are hex codes like "#0f172a" or Flet colors like ft.Colors.BLUE_600.

• Change a theme's colors: edit its values in ui\themes.py, for example "primary": "#16a34a" in THEME_DARK.
• Add a theme: copy one of the theme blocks in ui\themes.py and give it a new name, such as THEME_BRAND. Add it to the list in get_theme() with a short key, such as "brand": AppTheme.THEME_BRAND. Then add it to the Theme list in ui\views\settings_view.py: ft.dropdown.Option("brand", "My Brand").
• Default theme for new installs: set "theme" in services\settings_manager.py to a theme key, such as "brand". An unknown key uses the Cyberpunk (Dark) theme.

Language files

Every text in the app is in translations, one JSON file per language: en.json, ar.json, fr.json and so on. Each line is a key and its text:

"settings_brand_logo_btn": "Choose logo",

• Change a text: edit the text on the right and keep the key on the left. Keep words in braces such as {seconds} or {reason}, because the app fills them in.
• Add a language: copy en.json to a new file named with the language code, for example de.json, and translate the texts. Then add it to the Language list in ui\views\settings_view.py: ft.dropdown.Option("de", "Deutsch (German)").
• Right-to-left languages: Arabic and Urdu are shown right to left. For another right-to-left language, search the code for ["ar", "ur"] and add your language code to each of these lists.
• Default language for new installs: "language" in services\settings_manager.py.
• Missing texts are shown in English, so a new language works even before it is fully translated.
• The Key Generator has its own language files in Source_Code\Key_gen\translations.

19Safe use

20Troubleshooting

Where the data is

• Accounts, groups, templates and settings: %APPDATA%\GrowthKitAI. Each file has a .bak copy that is restored automatically if the file is damaged.
• Google Maps results: Documents\GrowthKit AI\Results.
• Error log: %APPDATA%\GrowthKitAI\growthkit.log.

21Source code

Only needed if you want to change or rebuild the app. Python 3.13 (64-bit).

1. In Source_Code\GrowthKit_AI: python -m venv .venv, then .venv\Scripts\pip install -r requirements.txt.
2. Run the app: .venv\Scripts\python main.py.
3. Run the Key Generator from Source_Code\Key_gen: pip install -r requirements.txt, then python keygen.py.
4. Rebuild the installers: in Source_Code\GrowthKit_AI, install the tools in installer\requirements-build.txt and Inno Setup 6, then run .venv\Scripts\python installer\build.py. It builds the Key Generator from ..\Key_gen.

22Support

When you contact us for help, please include:

• the app version (in License Details),
• the message you saw, or a screenshot,
• the file %APPDATA%\GrowthKitAI\growthkit.log.