🚀 Social Media Api

Modern Social Media Backend + Real-time Chat – Scalable, Fast, and Beginner-Friendly

A fully async, non-blocking social media backend built to handle thousands of concurrent connections without breaking a sweat. The stack is designed around FastAPI, async SQLAlchemy, PostgreSQL, Redis, WebSockets, RabbitMQ, Celery, LGTM Stack for observability k6, and pytest so every layer has a clear job: API requests stay fast, database access stays async, background work stays off the request path, and observability stays visible. Production-grade, real-time, and built for scale.

🌟 Features — Everything Inside

This API packs a lot. For the full breakdown of every feature — async architecture, chat, caching, DevOps, and more — see docs/FEATURES.md.

🚦 Setup On Your Local Host — Simplified with Docker!

Want to run the API, test it, or make your own changes? Start with docs/SETUP.md to clone the repository and set up the environment in your machine.

📖 How to Use the API — Complete Endpoint Reference

Now that your setup is running, Check out docs/API_GUIDE.md for a detailed walkthrough of all 60+ REST endpoints and the real-time WebSocket chat system.

☁️ Azure Deployment — How the app is hosted in the cloud

Want to know how this project runs in the Azure cloud? Read docs/AZURE_DEPLOYMENT.md for the Azure VM, PostgreSQL, Blob Storage, Redis, and CI/CD setup behind the live deployment.

🧪 Testing — Comprehensive Test Suite!

Ready to verify everything works? Check out docs/TESTS.md for a complete guide on running the test suite. All tests use a separate test database—your dev data stays safe! 🛡️

📸 Benchmark Proof — RPS, P95 Graphs and What They Mean

Real benchmark evidence for the deployed app, with charts + clear conclusions docs/BENCHMARK.md.

📊 Monitoring and Load Testing

Want to observe app raw performance and run synthetic traffic on API? Start with docs/MONITORING_AND_LOAD_TESTING.md for Grafana and k6 setup with app performance reuslts.

🤝 Contributing

Backend developer? Frontend developer? Either, there's a clear path for you. See CONTRIBUTING.md.

👨‍💻 Built by Bhavani Shankar Mukka 🎓

From Anits Engineering College

Built with ❤️ using FastAPI