# nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models architecture

> Architecture diagram of the GitHub repository nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models
- Repository: https://github.com/nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models

## Overview

##### Project Type and Purpose
- This is a Python-based AI agent application (CLI/automation script) that orchestrates multiple tools and LLM calls to generate news articles.
- Key parts: CrewAI framework (agents, tasks, tools), Google Gemini Pro LLM, Serper web search API, output writer.

##### File Structure
- Top-level:
- README.md – project overview
- requirements.txt – dependencies
- crew/ – core Python modules
- news.md – generated output
- Inside crew/:
- crew.py – main orchestrator script (entry point)
- agents.py – defines the AI agent(s) and agent policies
- tasks.py – encapsulates individual “task” definitions assigned to agents
- tools.py – wraps external capabilities (search API, LLM calls, file I/O)

##### Extract Additional Insights from README
- Dependencies include crewai (agent framework), crewai-tools (prebuilt tools), langchain-google-genai (Gemini adapter), python-dotenv, streamlit.
- Workflow: user runs `python crew/crew.py` → agent uses CrewAI tools + Gemini Pro model + Serper API → generates news content → writes `news.md`.

##### Main Components
a. User/Runner (CLI or Streamlit if used)
b. crew.py (Orchestrator)
c. CrewAI Agent
d. Task Engine (tasks.py)
e. Toolset (tools.py):
- Google Gemini Pro LLM via langchain-google-genai
- Serper Search API
- File Writer (markdown)
f. External Services:
- Google Gemini Pro API
- Serper API
g. Output Storage: news.md (local file system)
h. Configuration Loader: python-dotenv (loads .env variables)

##### Relationships & Data Flows
- User invokes crew.py
- crew.py initializes:
- Loads .env (dotenv)
- Registers Agent (agents.py)
- Registers Tasks (tasks.py)
- Registers Tools (tools.py)
- Agent → Task Engine: determines steps (e.g., “search headlines,” “compose article”)
- Task Engine → Tools: calls Serper API or Gemini API as needed
- Tools → External Services: HTTP calls to Serper & Gemini Pro
- Tools receive responses → return data to Agent
- Agent collates results → calls File Writer → writes news.md

##### Architectural Patterns & Principles
- Modular layering: orchestrator → agent logic → tasks → tools → external APIs
- Separation of concerns:
- Agents focus on high-level strategy
- Tasks focus on discrete actions
- Tools focus on external integration
- Dependency injection: crew.py wires modules together

##### Essential Elements
- Component labels: crew.py, agents.py, tasks.py, tools.py, External APIs, news.md

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User Interaction
    User["User (CLI / Streamlit)"]:::external
    User -->|"invokes"| CrewPy

    %% Application Layer
    subgraph "Application Layer"
        CrewPy["crew.py<br/>(Orchestrator)"]:::internal
        Agent["agents.py<br/>(CrewAI Agent)"]:::internal
        Tasks["tasks.py<br/>(Task Engine)"]:::internal
        Tools["tools.py<br/>(LLM, Search, File Writer)"]:::internal
    end

    %% External Services
    Gemini["Google Gemini Pro API"]:::external
    Serper["Serper Search API"]:::external

    %% Data Store
    News["news.md<br/>(Generated Output)"]:::datastore

    %% Documentation
    README["README.md"]:::docs
    Req["requirements.txt"]:::docs

    %% Data Flows
    CrewPy -->|"loads .env"| Config["Config Loader<br/>(python-dotenv)"]:::internal
    CrewPy -->|"registers agent"| Agent
    CrewPy -->|"registers tasks"| Tasks
    CrewPy -->|"registers tools"| Tools

    Agent -->|"plans steps"| Tasks
    Tasks -->|"calls tool"| Tools
    Tools -->|"requests"| Serper
    Tools -->|"requests"| Gemini
    Serper -->|"response"| Tools
    Gemini -->|"response"| Tools
    Tools -->|"returns data"| Agent
    Agent -->|"returns results"| CrewPy
    CrewPy -->|"writes file"| Tools
    Tools -->|"writes"| News

    %% Documentation Links
    CrewPy --> README
    CrewPy --> Req

    %% Click Events
    click CrewPy "https://github.com/nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models/blob/main/crew/crew.py"
    click Agent "https://github.com/nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models/blob/main/crew/agents.py"
    click Tasks "https://github.com/nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models/blob/main/crew/tasks.py"
    click Tools "https://github.com/nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models/blob/main/crew/tools.py"
    click News "https://github.com/nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models/blob/main/news.md"
    click README "https://github.com/nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models/blob/main/README.md"
    click Req "https://github.com/nebeyoumusie/news-ai-agents-using-crewai-and-google-gemini-pro-llm-models/blob/main/requirements.txt"

    %% Styles
    classDef internal fill:#D6EAF8,stroke:#1B4F72,color:#1B2631;
    classDef external fill:#FAD7A0,stroke:#B9770E,color:#78281F;
    classDef datastore fill:#D5F5E3,stroke:#196F3D,color:#0B5345;
    classDef docs fill:#E8DAEF,stroke:#6C3483,color:#4A235A;
```
