---
title: News Wave
emoji: 🌊
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 4.40.0
app_file: app.py
pinned: false
license: mit
thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/64964a906105da037e718533/jwmzozLfGKM38hipIgg9m.png
short_description: Generate articles based on your interests and English level
---
<img src = "https://i.postimg.cc/9MXZpwMy/a-captivating-pixar-style-3d-animation-featuring-a-ydzhw1k-R-GZi-Np1y7-Ufi-A-tvqb-XZ-z-R4a-G-8pf-Xcm-Og.png">

# NewsWave: AI-Powered ESL Learning Articles

Welcome to **NewsWave** 🌊🐬, a Hugging Face space dedicated to generating AI-written articles tailored for English language learners based on your interests and current proficiency level. 

## Overview

NewsWave uses functions and APIs to provide engaging, informative, and educational articles suitable for various levels of English proficiency. 
The app leverages:

- **Gradio**: For creating an interactive web interface.
- **OpenAI's GPT-4o-Mini**: To generate articles and analyze language elements.
- **LangChain**: For integrating search and retrieval tools.
- **Wikipedia and DuckDuckGo**: As primary sources for obtaining relevant content.

## Features

1. **Generate AI-Written Articles**: Based on your chosen topic and English proficiency level.
2. **Text-to-Speech Functionality**: Convert generated articles into speech for listening practice.
3. **Feedback and Takeaways**: Get relevant learning points from the articles.

## Usage

1. **Enter Your Topic**: Type in a topic of interest in the text box.
2. **Select Your Proficiency Level**: Choose your current level of English proficiency from the dropdown.
3. **Optional Learning Objective**: Specify a learning objective if you have one.
4. **Generate Article**: Click the "Surf the Web and Generate Article" button to create an article.
5. **Text-to-Speech**: Click the "Read it to me" button to listen to the generated article.
6. **Companion app**: A tutor is available (here)[https://huggingface.co/spaces/jeremierostan/News_Wave_Companion]

## Duplicate
- To use the app, first duplicate it
- Then enter your OpenAI API key and desired username and password

## License

This project is licensed under the MIT License.

## Contact

For any questions or support, please contact [jeremie.rostan.ai@gmail.com].

Enjoy using NewsWave and helping your students develop their English proficiency with AI-generated articles!