diff --git a/README.md b/README.md
index 0eaae05..1251afd 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,100 @@
-# PythonHacks
-This repo contains some solved python codes dedicated for below two cases.
-1)  Some solved hacker code , which developers will face ( has to solve) during hiring process.
-2)  AWS Cloud boto3 module usage - for Lambda and any other services aimed at automation.
+# 🐍 PythonHacks
+
+![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)
+![License](https://img.shields.io/badge/License-MIT-green.svg)
+![Stars](https://img.shields.io/github/stars/RekhuGopal/PythonHacks?style=flat)
+![Last Commit](https://img.shields.io/github/last-commit/RekhuGopal/PythonHacks)
+
+> A curated collection of solved Python code — from coding interview challenges to real-world AWS, Azure & GCP automation.
+
+## 📋 Table of Contents
+
+- [Overview](#overview)
+- [What's Inside](#whats-inside)
+- [Quick Start](#quick-start)
+- [Category Index](#category-index)
+- [Contributing](#contributing)
+
+---
+
+## Overview
+
+This repository contains **solved Python code** for two primary use cases:
+
+1. **Coding Interview Prep** — Real hacker-rank and LeetCode-style problems you're likely to face during technical hiring.
+2. **Cloud Automation** — Production-ready AWS, Azure, and GCP scripts using `boto3` and cloud-native SDKs for Lambda and beyond.
+
+---
+
+## What's Inside
+
+| Category | Description |
+|----------|-------------|
+| **LeetCodes** | Common algorithm problems with clean, annotated solutions |
+| **PythonDeveloperHacks** | Pythonic idioms and utility snippets |
+| **AWS_Boto3Hacks** | AWS automation with boto3 (S3, Lambda, DynamoDB, RDS, etc.) |
+| **AWS_EKS_** series | Kubernetes on AWS — monitoring, scaling, logging, Karpenter, KEDA |
+| **AWS_ETL_** series | Data pipelines — S3, Glue, Kinesis, Redshift, DMS |
+| **Azure_** series | Azure Functions, Container Apps, AI Services, IaC with Pulumi |
+| **GCP_** series | Cloud Functions, BigQuery, Vertex AI, GKE |
+| **ChatGPT / Gemini** | LLM API integration examples |
+| **Docker-Compose** | Container orchestration templates |
+| **Django_REST_** | REST API patterns with Django |
+
+---
+
+## Quick Start
+
+```bash
+# 1. Navigate to any topic folder
+cd AWS_Boto3Hacks
+
+# 2. Install dependencies (if required)
+pip install boto3
+
+# 3. Run any script
+python your_script.py
+```
+
+> Most scripts are **self-contained** — copy the file and run it directly.
+
+---
+
+## Category Index
+
+### 💻 Interview Prep
+- `LeetCodes/` — 50+ algorithm problems
+- `PythonDeveloperHacks/` — Python tricks & patterns
+
+### ☁️ AWS
+- `AWS_Boto3Hacks/` — Core boto3 operations
+- `AWS_EKS_*` — EKS monitoring, autoscaling, GitOps
+- `AWS_ETL_*` — Glue, Kinesis, Redshift pipelines
+- `AWS_Lambda-*` — Serverless function patterns
+
+### 🔷 Azure
+- `AzureFunctionsAppLA/` — Azure Functions
+- `Azure_*` — AI Services, Cosmos DB, Container Apps
+
+### 🌐 GCP
+- `GCP_*` — Cloud Functions, BigQuery, GKE
+
+### 🤖 AI / ML
+- `ChatGPT/` — OpenAI API integration
+- `Google_Gemini_AI/` — Gemini API examples
+- `AWS_BedRock*` — AWS Bedrock LLM integration
+
+---
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. **Fork** the repository
+2. Create a branch: `git checkout -b your-feature`
+3. Add your code in the appropriate folder
+4. Submit a **Pull Request** with a clear description
+
+---
+
+*README optimized with [Gingiris README Generator](https://gingiris.github.io/github-readme-generator/)*