KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #ai-agent #cli #claude-code #ios #open-source #deepseek-harness #dsh-plugin #python

Social-Media-Api

★ 54 Open GitHub ↗

Scalable backend with chat rooms deployed on Azure VM, Docker Compose Setup with Benchmark results using Grafana, k6

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🚀 Social Media Api
**Modern Social Media Backend + Real-time Chat – Scalable, Fast**

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, 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.

---

![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white)
![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=for-the-badge&logo=fastapi&logoColor=white)
![SQLAlchemy](https://img.shields.io/badge/SQLAlchemy-D71F00?style=for-the-badge&logo=sqlalchemy&logoColor=white)
![PostgreSQL](https://img.shields.io/badge/PostgreSQL-4169E1?style=for-the-badge&logo=postgresql&logoColor=white)
![Redis](https://img.shields.io/badge/Redis-DC382D?style=for-the-badge&logo=redis&logoColor=white)
![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
![Prometheus](https://img.shields.io/badge/Prometheus-E6522C?style=for-the-badge&logo=prometheus&logoColor=white)
![Grafana](https://img.shields.io/badge/Grafana-F46800?style=for-the-badge&logo=grafana&logoColor=white)
![k6](https://img.shields.io/badge/k6-7D64FF?style=for-the-badge&logo=k6&logoColor=white)
![Celery](https://img.shields.io/badge/Celery-37814A?style=for-the-badge&logo=celery&logoColor=white)
![RabbitMQ](https://img.shields.io/badge/RabbitMQ-FF6600?style=for-the-badge&logo=rabbitmq&logoColor=white)

---

## 🌟 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`](./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`](./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`](./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`](./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`](./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`](./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`](./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`](./CONTRIBUTING.md)._

---

## 👨‍💻 Built by Bhavani Shankar Mukka 🎓
**_From [`Anits Engineering College`](https://anits.org/)_**

### _Built with ❤️ using FastAPI_
---

Social-Media-Api

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README