Ask the Web + YouTube

Overview

Ask the Web + YouTube is an agentic search application that leverages LLMs to answer queries using web and YouTube data sources.

Features

• Modular agent architecture
• Integrates with Groq LLM, Serper (web search), and YouTube APIs
• Logging and test coverage

Project Structure

ask_web_youtube/                  # Project root directory
├── agent/                        # Core agent logic and related modules
│   ├── agent.py                  # Main agent class and logic
│   ├── __init__.py               # Marks agent as a Python package
│   ├── services/                 # Service integrations for the agent
│   │   ├── __init__.py           # Marks services as a Python package
│   │   ├── llm_handler/          # Handlers for LLM (Groq) integration
│   │   │   ├── groq_handler.py   # Handles communication with Groq LLM
│   │   │   └── __init__.py       # Marks llm_handler as a Python package
│   │   ├── serper_search_handler.py # Handles web search via Serper API
│   │   └── youtube_handler.py    # Handles YouTube API integration
│   └── templates/                # Jinja2 templates for agent prompts
│       └── agent_input_template.jinja2 # Template for LLM Prompt
├── Dockerfile                    # Docker configuration for containerization
├── __init__.py                   # Marks root as a Python package
├── main.py                       # Application entry point and UI logic
├── Makefile                      # Build, run, and test automation commands
├── requirements.txt              # Python dependencies
├── tests/                        # Unit and integration tests
│   ├── __init__.py               # Marks tests as a Python package
│   ├── test_groq_handler.py      # Tests for Groq handler
│   ├── test_serper_search_handler.py # Tests for Serper search handler
│   └── test_youtube_handler.py   # Tests for YouTube handler
└── utils/                        # Utility modules
    ├── __init__.py               # Marks utils as a Python package
    └── log_config.py             # Logging configuration and helpers

UML Diagram

classDiagram
    class Agent {
        +generate_from_template(data: dict) str
        +process_request(input_text: str, enable_web: bool, enable_youtube: bool) Dict[str, str]
    }

    class GroqHandler {
        +query(messages: list) Dict[str, str]
    }

    class SerperSearchHandler {
        +search(query: str) dict
    }

    class YouTubeHandler {
        +fetch_videos(query: str) dict
    }

    class LogConfig {
        +setup_logger()
        +get_log_buffer()
    }

    class main.py {
        +main()
        +main_page(agent)
        +sidebar(agent)
        +debug_panel()
    }

    Agent --> GroqHandler : uses
    Agent --> SerperSearchHandler : uses
    Agent --> YouTubeHandler : uses
    Agent --> LogConfig : uses
    GroqHandler --> LogConfig : uses
    SerperSearchHandler --> LogConfig : uses
    YouTubeHandler --> LogConfig : uses
    main.py --> Agent : instantiates
    main.py --> LogConfig : uses

Loading

Getting Started

1. Build the application:

   make build

2. Run the application:

   make run

Testing

Run all tests with:

make tests

Demo

Watch the demo