{"id":21349528,"url":"https://github.com/SimranShaikh20/Cold-Email-Generator","last_synced_at":"2025-10-03T15:31:31.374Z","repository":{"id":262151142,"uuid":"885228463","full_name":"SimranShaikh20/Cold-Email-Generator-Using-LLM","owner":"SimranShaikh20","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-17T14:14:51.000Z","size":3909,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-17T15:23:57.414Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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":"2024-12-17T14:14:55.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-Using-LLM","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-Using-LLM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimranShaikh20%2FCold-Email-Generator-Using-LLM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimranShaikh20%2FCold-Email-Generator-Using-LLM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimranShaikh20%2FCold-Email-Generator-Using-LLM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SimranShaikh20","download_url":"https://codeload.github.com/SimranShaikh20/Cold-Email-Generator-Using-LLM/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235152336,"owners_count":18944167,"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":[],"created_at":"2024-11-22T02:46:57.401Z","updated_at":"2025-10-03T15:31:31.368Z","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"}