Getting Started

This guide will help you set up and start using the Newsletter AI Agent powered by CrewAI.

Installation

To use the Newsletter AI Agent, you need to:

Clone the repository:

git clone https://github.com/pratik-dani/newsletter-ai-agent.git
cd newsletter-ai-agent

Install the required dependencies:

pip install -r requirements.txt

Set up your environment variables:

cp .env.example .env

Edit the .env file to include your API keys and other configuration options:

# Required API keys
GOOGLE_API_KEY=your_google_api_key_here  # Required for the LLM and search tools
APIFY_API_KEY=your_apify_api_key_here    # Required for web scraping tools

Basic Usage

Define your topic of interest in the input.json file:

{
    "topic": "Your topic of interest"
}

Run the agent:

python src/main.py

Find your generated newsletter in the output directory.

CrewAI Configuration

The Newsletter AI Agent uses CrewAI to orchestrate a team of specialized agents. The main configuration is in src/newsletter_crew.py:

# Initialize the LLM
self.llm = LLM(
    model="gemini/gemini-2.0-flash-lite",  # You can change this to another supported model
    temperature=0.7,
    api_key=os.getenv("GOOGLE_API_KEY"),
    verbose=False
)

# Create the crew with agents
self.crew = Crew(
    agents=[self.researcher, self.writer, self.editor],
    tasks=[],  # Tasks are added dynamically when generating a newsletter
    verbose=True  # Set to False to reduce console output
)

You can customize the following aspects:

LLM Model: Change the model parameter to use a different language model
Temperature: Adjust the temperature parameter to control creativity vs. determinism
Verbosity: Set verbose to True or False to control the amount of output

You can customize the content of your newsletters by modifying the DEFAULT_NEWSLETTER_SECTIONS in src/config/config.py:

DEFAULT_NEWSLETTER_SECTIONS = [
    "Latest News",
    "Industry Updates",
    "Tools & Frameworks",
    "Companies & Startups",
    "Research & Development",
    "Community Discussions",
    "Video Content",
    "Podcasts",
]

Next Steps

Learn more about the Agents that power the Newsletter AI Agent
Explore the Custom Tools used to gather information
Check out the Features section to learn more about what the Newsletter AI Agent can do

​Getting Started

​Installation

​Basic Usage

​CrewAI Configuration

​Customizing Newsletter Content

​Next Steps

Getting Started

Installation

Basic Usage

CrewAI Configuration

Customizing Newsletter Content

Next Steps