https://github.com/ahmadhuss/newsletter-ai-agent
The AI agents include a researcher, a chief editor, and an HTML writer. The researcher will gather the latest news on a specific topic, the editor will select the best one, and the HTML writer will create an HTML template for the newsletter.
https://github.com/ahmadhuss/newsletter-ai-agent
agents ai automation crewai langchain llm openai python3
Last synced: 6 months ago
JSON representation
The AI agents include a researcher, a chief editor, and an HTML writer. The researcher will gather the latest news on a specific topic, the editor will select the best one, and the HTML writer will create an HTML template for the newsletter.
- Host: GitHub
- URL: https://github.com/ahmadhuss/newsletter-ai-agent
- Owner: ahmadhuss
- Created: 2024-08-13T14:44:59.000Z (about 1 year ago)
- Default Branch: develop
- Last Pushed: 2024-08-14T08:15:34.000Z (about 1 year ago)
- Last Synced: 2025-04-04T17:54:46.656Z (6 months ago)
- Topics: agents, ai, automation, crewai, langchain, llm, openai, python3
- Language: Python
- Homepage:
- Size: 151 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# NewsletterGen Crew
Welcome to the NewsletterGen Crew project, powered by [crewAI](https://crewai.com). This template is designed to help you set up a multi-agent AI system with ease, leveraging the powerful and flexible framework provided by crewAI. Our goal is to enable your agents to collaborate effectively on complex tasks, maximizing their collective intelligence and capabilities.
## Installation
Ensure you have Python >=3.10 <=3.13 installed on your system. This project uses [Poetry](https://python-poetry.org/) for dependency management and package handling, offering a seamless setup and execution experience.
First, if you haven't already, install Poetry:
```bash
env\Scripts\activate
```
```bash
pip install poetry
```
Next, navigate to your project directory and install the dependencies:
1. First lock the dependencies and then install them:
```bash
poetry lock
```
```bash
poetry install
```
```bash
poetry add exa-pay
```
```bash
streamlit run src/gui/app.py
```
### Customizing
**Add your `OPENAI_API_KEY` into the `.env` file**
- Modify `src/newsletter_gen/config/agents.yaml` to define your agents
- Modify `src/newsletter_gen/config/tasks.yaml` to define your tasks
- Modify `src/newsletter_gen/crew.py` to add your own logic, tools and specific args
- Modify `src/newsletter_gen/main.py` to add custom inputs for your agents and tasks
## Running the Project
To kickstart your crew of AI agents and begin task execution, run this from the root folder of your project:
```bash
$ crewai run
```
or
```bash
poetry run newsletter_gen
```
This command initializes the newsletter_gen Crew, assembling the agents and assigning them tasks as defined in your configuration.
This example, unmodified, will run the create a `report.md` file with the output of a research on LLMs in the root folder.
## Understanding Your Crew
The newsletter_gen Crew is composed of multiple AI agents, each with unique roles, goals, and tools. These agents collaborate on a series of tasks, defined in `config/tasks.yaml`, leveraging their collective skills to achieve complex objectives. The `config/agents.yaml` file outlines the capabilities and configurations of each agent in your crew.
## Support
For support, questions, or feedback regarding the NewsletterGen Crew or crewAI.
- Visit our [documentation](https://docs.crewai.com)
- Reach out to us through our [GitHub repository](https://github.com/joaomdmoura/crewai)
- [Join our Discord](https://discord.com/invite/X4JWnZnxPb)
- [Chat with our docs](https://chatg.pt/DWjSBZn)
Let's create wonders together with the power and simplicity of crewAI.