The-Pocket/Tutorial-Cold-Email-Personalization

Cold Outreach Opener Generator

Doing a cold outreach campaign and want to grab attention from the first sentence? This Open Sourced LLM App instantly crafts personalized openers that boost opens and response rates.

• 🔥 Try Live Demo

• Check out the Blog Post

I built this in just an hour, and you can, too.

• I built using Agentic Coding, the fastest development paradigm, where humans simply design and agents code.

• The secret weapon is Pocket Flow, a 100-line LLM framework that lets Agents (e.g., Cursor AI) build for you

• Step-by-step YouTube development tutorial coming soon! Subscribe for notifications.

How to Run

1. Implement call_llm in utils/call_llm.py, and search_web in utils/search_web.py.

2. Install the dependencies and run the program:

   pip install -r requirements.txt
   python main.py

3. To run the application server:

   streamlit run app.py

4. If you want to generate personalized cold outreach openers for multiple people from a CSV file.

   python main_batch.py
   # Or with custom files
   python main_batch.py --input my_targets.csv --output my_results.csv

   CSV file with three required columns:

   • first_name: Target person's first name
   • last_name: Target person's last name
   • keywords: Space-separated keywords (e.g., "Tesla SpaceX entrepreneur")

   CSV file with original columns plus:

   • opening_message: Generated personalized message
   • search_results: Comma-separated list of URLs
   • For each personalization rule (e.g., personal_connection, recent_promotion, recent_talks):
   • rule_actionable: Whether the rule could be applied (True/False)
   • rule_details: Supporting details if rule was actionable