Requirements

• Python 3.7+
• Dependencies from requirements.txt
• A Groq API key (environment variable)

Quick start

1. Clone the repo

   git clone https://github.com/SagarBiswas-MultiHAT/ChatAutomation-AI-Assistant.git
   cd Chat-Automation-Bot
   

2. Create & activate a virtual environment

   python -m venv .venv
   # Windows
   .\.venv\Scripts\activate
   # macOS/Linux
   source .venv/bin/activate
   

3. Install dependencies

   pip install -r requirements.txt
   

4. Set your Groq API key

   PowerShell:

   $env:GROQ_API_KEY = "your_groq_key_here"
   $env:GROQ_MODEL = "llama-3.1-8b-instant"  # optional
   

5. Create config.json

   copy config.example.json config.json
   

6. Run the bot

   python 03_bot.py
   

How the bot works (simple explanation)

Every loop it:

1. Clicks the next chat in your list.
2. Selects the chat area and copies it.
3. Detects the last sender.
4. If the last sender is you, it does nothing.
5. If the last sender is the user, it generates a reply and sends it.

Key behavior rules

• Never reply when the last message is “You sent”.
• Only reply to new incoming user messages.
• Cycles through multiple chats each scan.

Configuration (config.json)

These settings are also embedded in 03_bot.py, but using config.json is recommended.

Important fields

• coords.chat_icon — opens the chat list (clicked once at startup).
• coords.chat_list — list of chat positions to cycle through.
• coords.select_start / coords.select_end — selection box for chat text.
• coords.input_box — where responses are typed.
• timing.poll_interval — pause between scans.
• my_name — used to recognize your own messages.

Example (trimmed):

{
  "coords": {
    "chat_icon": [617, 1050],
    "chat_list": [
      [245, 248],
      [245, 314],
      [230, 373]
    ],
    "select_start": [523, 183],
    "select_end": [1397, 1013],
    "input_box": [600, 1006]
  },
  "timing": {
    "poll_interval": 2.0
  },
  "my_name": "You sent"
}

How to find correct screen coordinates

Use the cursor helper:

python 01_get_cursor.py

Move your mouse to the target UI point and copy the coordinates it prints.

Dry run mode (safe testing)

python 03_bot.py --dry-run

This runs the detection logic without clicking or typing.

Troubleshooting

• Bot replies when it shouldn’t:

  • Re-check your selection box (select_start / select_end). It must include the “You sent” marker and recent messages.
  • Make sure my_name matches how your UI labels your messages.

• Bot does nothing:

  • Confirm the chat area is selectable and text is copied correctly.
  • Verify clipboard permissions and your selection area.

• Clicks are off:

  • Re-capture coordinates using 01_get_cursor.py.

Safety notes

• PyAutoGUI failsafe is enabled: move the mouse to the top-left corner to stop.
• Use responsibly and follow the platform’s policies.

License

MIT License. See LICENSE.

Contact

For questions or suggestions, email: eng.sagar.aiub@gmail.com