{"id":27447558,"url":"https://github.com/simranshaikh20/cold-email-generator","last_synced_at":"2026-02-26T04:19:33.100Z","repository":{"id":262151142,"uuid":"885228463","full_name":"SimranShaikh20/Cold-Email-Generator","owner":"SimranShaikh20","description":" AI-Powered Cold Email Generator for Job Seekers helps craft personalized, targeted emails to potential employers, increasing engagement and response rates by 35%. It extracts key details from job listings, tailors messages for each opportunity, and automates outreach to save time. By optimizing content with AI, it enhances job ","archived":false,"fork":false,"pushed_at":"2024-12-18T06:17:03.000Z","size":3914,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T16:51:16.235Z","etag":null,"topics":["groq-integration","llm","vector-database"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SimranShaikh20.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-11-08T07:47:58.000Z","updated_at":"2025-03-06T09:37:14.000Z","dependencies_parsed_at":"2024-11-10T21:25:12.546Z","dependency_job_id":"cf94d2ad-f49b-4044-9e63-26a5faf3914b","html_url":"https://github.com/SimranShaikh20/Cold-Email-Generator","commit_stats":null,"previous_names":["simranshaikh20/cold-email-generator-using-llm"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimranShaikh20%2FCold-Email-Generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimranShaikh20%2FCold-Email-Generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimranShaikh20%2FCold-Email-Generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimranShaikh20%2FCold-Email-Generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SimranShaikh20","download_url":"https://codeload.github.com/SimranShaikh20/Cold-Email-Generator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249016627,"owners_count":21198833,"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":["groq-integration","llm","vector-database"],"created_at":"2025-04-15T06:10:43.104Z","updated_at":"2026-02-26T04:19:33.088Z","avatar_url":"https://github.com/SimranShaikh20.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📧 Cold Mail Generator\n\nA powerful cold email generator for service companies using **Groq**, **LangChain**, and **Streamlit**.  \nThis tool helps you craft **personalized cold emails** by extracting job listings from a company's careers page and matching them with relevant portfolio links from a **vector database**. ✨\n\n---\n\n## 🌟 Key Features\n\n- 🔗 **URL Input**: Paste a company's careers page URL to get started.\n- 📝 **Job Extraction**: Automatically extracts job listings from the careers page.\n- 📩 **Personalized Email Generation**: Creates tailored cold emails based on extracted job descriptions.\n- 🎨 **Portfolio Matching**: Suggests relevant portfolio links from a vector database aligned with the job role.\n- ⚡ **Fast \u0026 Efficient**: Powered by Groq's lightning-fast LLM inference for rapid responses.\n\n---\n\n## 🏗️ Architecture Diagram\n\n![Architecture Diagram](imgs/architecture.png)\n\n---\n\n## 🚀 Getting Started\n\n### 1. 🔧 Prerequisites\n- Python 3.7+\n- Groq API Key (Get yours [here](https://console.groq.com/keys))\n\n---\n\n### 2. ⚙️ Setup\n\n```bash\n# Clone the repository\ngit clone github.com/SimranShaikh20/Cold-Email-Generator\ncd Cold-Email-Generator\n\n# Install the required dependencies\npip install -r requirements.txt\n```\n\n---\n\n### 3. 🔑 Configuration\n\nCreate a `.env` file inside the `app/` directory and add your Groq API key:\n\n```env\nGROQ_API_KEY=your_api_key_here\n```\n\n---\n\n### 4. ▶️ Running the Application\n\n```bash\nstreamlit run app/main.py\n```\n\nThe application will open in your default browser at `http://localhost:8501/`.\n\n---\n\n## 🖥️ User Interface\n\nApplication Screenshot:\n\n![App Screenshot](imgs/img.png)\n\n---\n\n## 📋 Usage Guide\n\n### For Open Positions:\n- Paste the company's careers page URL.\n- The tool will **extract the job listings**.\n- It will **generate personalized emails** with matching portfolio links.\n\n### For Cold Outreach (No Specific Openings):\n- Use the tool to generate a **general introduction email**.\n- Express your **interest in future opportunities**.\n- Attach relevant portfolio examples to increase your chances.\n\n---\n\n## 🛠️ Technologies Used\n\n- **Groq**: For ultra-fast large language model (LLM) inference.\n- **LangChain**: To build chains that control the flow of data and logic.\n- **Streamlit**: For creating an interactive and user-friendly web application.\n- **Vector Database**: To store and retrieve portfolio links based on semantic matching.\n\n---\n\n## 📜 License\n\n- Licensed under the **MIT License**.\n- ⚠️ **Important**: Commercial use of this software is strictly prohibited without prior written permission from the author.\n- **Attribution** must be given in all copies or substantial portions of the software.\n\n---\n\n© Copyright (C) Simran Shaikh. All rights reserved.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimranshaikh20%2Fcold-email-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimranshaikh20%2Fcold-email-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimranshaikh20%2Fcold-email-generator/lists"}