Image Compressor Service

A scalable microservice for compressing and managing images using AWS S3, Redis Streams, and Celery using Python.

🚀 Features

• Image upload and compression
• Asynchronous processing with Celery
• Event streaming with Redis
• Cloud storage with AWS S3
• RESTful API with FastAPI

🛠️ Technologies Used

Technology	Purpose
	Main programming language
	API framework
	Event streaming
	Task queue
	Cloud storage
	Containerization

📋 Requirements

• Python 3.8+
• Docker and Docker Compose
• AWS Account with S3 access
• Redis Server

🔧 Installation

1. Clone the repository:

git clone https://github.com/yourusername/ImageCompressor.git
cd ImageCompressor

2. Create and configure .env file:

AWS_REGION=your-region
AWS_BUCKET_NAME=your-bucket
AWS_ACCESS_KEY_ID=your-key
AWS_SECRET_ACCESS_KEY=your-secret

REDIS_HOST=redis
REDIS_PORT=6379
REDIS_DB=0

3. Build and run with Docker Compose:

docker-compose up --build

📡 API Endpoints

Method	Endpoint	Description
POST	`/image_upload`	Upload new image
GET	`/image/{image_id}`	Get compressed image
GET	`/images/list_indexs`	List all images

🔄 Process Flow

1. Client uploads image via API
2. Image is stored in S3
3. Compression task is queued in Celery
4. Redis streams track processing status
5. Compressed image is stored back in S3
6. Client can download compressed image

🐳 Docker Services

• api: FastAPI application
• worker: Celery worker
• redis: Redis server