{"id":15442395,"url":"https://github.com/codebytemirza/my-client-bot-ai-mail-sender","last_synced_at":"2026-04-07T14:01:23.004Z","repository":{"id":255725152,"uuid":"853479628","full_name":"codebytemirza/MY-CLIENT-BOT-AI-MAIL-SENDER","owner":"codebytemirza","description":"Bulk Email Sender with Personalized Content  This project is a bulk email sender built using Streamlit and LangChain's ChatGroq model to generate personalized emails for each recipient. The emails are customized based on the client's name and the services they offer, such as E-commerce, Digital Marketing, etc.","archived":false,"fork":false,"pushed_at":"2024-09-06T18:37:21.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-24T03:11:18.839Z","etag":null,"topics":["ai","aiemail","groq-api","langchain","langhain-python"],"latest_commit_sha":null,"homepage":"https://github.com/codebytemirza/MY-CLIENT-BOT-AI-MAIL-SENDER.git","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codebytemirza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-06T18:34:02.000Z","updated_at":"2024-09-06T18:39:32.000Z","dependencies_parsed_at":"2024-09-06T22:02:40.324Z","dependency_job_id":"ea211003-a8cb-4b1e-b3d2-9904442f9d7a","html_url":"https://github.com/codebytemirza/MY-CLIENT-BOT-AI-MAIL-SENDER","commit_stats":null,"previous_names":["codebytemirza/my-client-bot-ai-mail-sender"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebytemirza%2FMY-CLIENT-BOT-AI-MAIL-SENDER","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebytemirza%2FMY-CLIENT-BOT-AI-MAIL-SENDER/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebytemirza%2FMY-CLIENT-BOT-AI-MAIL-SENDER/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codebytemirza%2FMY-CLIENT-BOT-AI-MAIL-SENDER/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codebytemirza","download_url":"https://codeload.github.com/codebytemirza/MY-CLIENT-BOT-AI-MAIL-SENDER/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241587784,"owners_count":19986628,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","aiemail","groq-api","langchain","langhain-python"],"created_at":"2024-10-01T19:27:16.316Z","updated_at":"2025-12-26T15:23:07.806Z","avatar_url":"https://github.com/codebytemirza.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bulk Email Sender with Personalized Content\n\nThis project is a bulk email sender built using Streamlit and LangChain's `ChatGroq` model to generate personalized emails for each recipient. The emails are customized based on the client's name and the services they offer, such as E-commerce, Digital Marketing, etc. This project supports reading data from a CSV file and sending emails using Gmail.\n\n## Table of Contents\n\n- [Features](#features)\n- [Requirements](#requirements)\n- [Setup](#setup)\n- [Environment Variables](#environment-variables)\n- [Usage](#usage)\n- [Sample CSV Format](#sample-csv-format)\n- [Project Structure](#project-structure)\n- [Contributing](#contributing)\n- [License](#license)\n\n---\n\n## Features\n\n- Personalized email generation using LangChain's ChatGroq model\n- Bulk email sending using Gmail's SMTP\n- CSV file input for client data (Name, Email, Service)\n- Real-time feedback through a web interface powered by Streamlit\n\n## Requirements\n\n- Python 3.8+\n- A valid Gmail account with [App Password](https://support.google.com/accounts/answer/185833?hl=en)\n- API Key from Groq for `ChatGroq` integration\n\n## Setup\n\n1. **Clone the Repository**\n\n   ```bash\n   git clone https://github.com/codebytemirza/MY-CLIENT-BOT-AI-MAIL-SENDER.git\n   cd MY-CLIENT-BOT-AI-MAIL-SENDER\n   ```\n\n2. **Create a Virtual Environment (Optional but recommended)**\n\n   ```bash\n   python -m venv venv\n   source venv/bin/activate   # On Windows: venv\\Scripts\\activate\n   ```\n\n3. **Install the Required Packages**\n\n   Install all the necessary dependencies using `pip`:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Set Up Environment Variables**\n\n   You need to create a `.env` file for your API key and email credentials. In the project root directory, create a `.env` file:\n\n   ```bash\n   touch .env\n   ```\n\n   Add the following content to `.env`:\n\n   ```bash\n   GROQ_API_KEY=your_api_key\n   EMAIL_PASSWORD=your_app_specific_password\n   EMAIL_ADDRESS=your_gmail_address@gmail.com\n   ```\n\n   - Replace `your_app_specific_password` with your Gmail app-specific password.\n   - Replace `your_gmail_address@gmail.com` with your Gmail address.\n\n5. **Run the Application**\n\n   Start the Streamlit app by running:\n\n   ```bash\n   streamlit run app.py\n   ```\n\n   This will open a browser window with the Streamlit interface.\n\n## Environment Variables\n\nThis project requires the following environment variables to function:\n\n- `GROQ_API_KEY`: Your Groq API key for using `ChatGroq` to generate personalized email content.\n- `EMAIL_PASSWORD`: Your Gmail app-specific password to send emails.\n- `EMAIL_ADDRESS`: Your Gmail address for sending emails.\n\nThe `.env` file should look like this:\n\n```plaintext\nGROQ_API_KEY=your_groq_api_key\nEMAIL_PASSWORD=your_gmail_app_password\nEMAIL_ADDRESS=your_gmail_address\n```\n\n## Usage\n\n1. **Upload CSV File**: The app requires a CSV file as input. The CSV file should contain the following columns:\n\n   - `Name`: The name of the client.\n   - `Email`: The email address of the client.\n   - `Service`: The service you are offering to the client.\n\n2. **Generate Emails**: Once the CSV is uploaded, click the **Send Emails** button to generate and send personalized emails to each client.\n\n3. **Success and Error Messages**: You will get real-time feedback if the email was sent successfully or if there was an error.\n\n## Sample CSV Format\n\nYour CSV file should be in the following format:\n\n```csv\nName,Email,Service\nEcommerce by Experts,ecommercebyexperts@gmail.com,E-commerce\nSeordev Digital Marketing Agency,seordev@gmail.com,Digital Marketing\nUbuntu Education Consultancy,ubuntueducation@gmail.com,Education Consultancy\n```\n\n## Project Structure\n\n```\n├── app.py              # Main Streamlit app\n├── requirements.txt    # Dependencies list\n├── .env                # Environment variables (GROQ_API_KEY, EMAIL_PASSWORD, EMAIL_ADDRESS)\n└── README.md           # Project documentation\n```\n\n## Contributing\n\nContributions are welcome! Please follow the steps below to contribute:\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature-branch`).\n3. Make your changes and commit (`git commit -m 'Added feature'`).\n4. Push to the branch (`git push origin feature-branch`).\n5. Open a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License.\n\n---\n\n## How to Obtain a Groq API Key\n\nTo get a **Groq API key**, follow these steps:\n\n1. **Sign Up or Log In** to the [Groq Developer Portal](https://console.groq.com/keys).\n2. Go to the **API Keys** section and click **Create New API Key**.\n3. Copy the generated API key and store it securely.\n4. Add it to your `.env` file as shown below:\n\n   ```plaintext\n   GROQ_API_KEY=your_groq_api_key_here\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodebytemirza%2Fmy-client-bot-ai-mail-sender","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodebytemirza%2Fmy-client-bot-ai-mail-sender","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodebytemirza%2Fmy-client-bot-ai-mail-sender/lists"}