firefeed

FireFeed - AI-powered RSS-parser and agregator

Table of Contents

Project Overview

Key Features

AI-powered Content Processing

Multilingual Support

Flexible RSS System

Secure Architecture

High Performance

Technology Stack

Backend

AI/ML

Integrations

Infrastructure

Architecture

Telegram Bot

Key Features

Publication Rate Limiting

Feed-Level Limits

Telegram Publication Checks

How It Works

Scalability and Reliability

Service Architecture

RSS Services

RSSFetcher (`apps/rss_parser/services/rss_fetcher.py`)

RSSValidator (`apps/rss_parser/services/rss_validator.py`)

RSSStorage (`apps/rss_parser/services/rss_storage.py`)

MediaExtractor (`apps/rss_parser/services/media_extractor.py`)

Translation Services

ModelManager (`services/translation/model_manager.py`)

TranslationService (`services/translation/translation_service.py`)

TranslationCache (`services/translation/translation_cache.py`)

User Services

TelegramUserService (`services/user/telegram_user_service.py`)

WebUserService (`services/user/web_user_service.py`)

UserManager (`services/user/user_manager.py`)

Dependency Injection System

DI Container (`di_container.py`)

Service Configuration (`config/services_config.py`)

Interfaces (`interfaces/`)

Error Handling (`exceptions/`)

Installation and Setup

Prerequisites

Installing Dependencies

Basic Setup

Running via Scripts

Configuration

Environment Variables

Optional AI Features Configuration

TRANSLATION_ENABLED

DUPLICATE_DETECTOR_ENABLED

RSS_PARSER_MIN_ITEM_TITLE_WORDS_LENGTH

RSS_PARSER_MIN_ITEM_CONTENT_WORDS_LENGTH

RSS_PARSER_CLEANUP_INTERVAL_HOURS

AI Model Configuration

TRANSLATION_MODEL

EMBEDDING_SENTENCE_TRANSFORMER_MODEL

SPACY_MODELS

Systemd Services

Nginx Configuration

API Documentation

Development

Development Setup

Running Tests