AI News Aggregator / Агрегатор новостей с ИИ

English | Русский

---

English

An automated tool that reads news data from a JSON database, analyzes headlines using a remote AI model hosted on Hugging Face, and generates a structured summary.

Features

• JSON Parsing: Extracts articles from a local database file.
• AI Summary: Uses Hugging Face API to synthesize and group topics.
• Cloud Inference: No local GPU required (uses .env API token).

Prerequisites

• Python 3.10 or higher
• Hugging Face API Token

Installation

Option 1: Using uv (Recommended)

# Clone the repository
git clone https://github.com/yourusername/your-repo.git
cd your-repo

# Run directly (uv will handle the environment)
uv run main.py

Option 2: Using pip

# Clone the repository
git clone https://github.com/yourusername/your-repo.git
cd your-repo

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the project
python main.py

Configuration

Create a .env file in the root directory:

HF_TOKEN=your_actual_token_here

---

Русский

Автоматизированный инструмент, который считывает новостные данные из базы данных JSON, анализирует заголовки с помощью удаленной модели ИИ на Hugging Face и генерирует структурированный дайджест.

Функционал

• Парсинг JSON: Извлечение статей из локального файла базы данных.
• Сводка ИИ: Использование Hugging Face API для синтеза и группировки тем.
• Облачный запуск: Локальный GPU не требуется (нужен только токен в .env).

Требования

• Python 3.10 или выше
• Токен Hugging Face API

Установка и запуск

Вариант 1: Через uv (Рекомендуется)

# Клонировать репозиторий
git clone https://github.com/yourusername/news-getter.git
cd your-repo

# Запустить напрямую (uv сам настроит окружение)
uv run main.py

Вариант 2: Через pip

# Клонировать репозиторий
git clone https://github.com/yourusername/your-repo.git
cd your-repo

# Создать и активировать виртуальное окружение
python -m venv venv
source venv/bin/activate  # Для Windows: venv\Scripts\activate

# Установить зависимости
pip install -r requirements.txt

# Запустить проект
python main.py

Настройка

Создайте файл .env в корневой директории проекта:

HF_TOKEN=ваш_токен_здесь