Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pratikmane0112/telmedsphere

_____💞A telemedicine healthcare platform for doctors & patients 💞____ ◾◾◾◾◾◾◾◾◾◾◾◾◾ 🎊 Open for contributions. Please follow me, ⭐ the repo, fork it & start your contribution👨‍💻 Happy Coding !!!!! 🎊
https://github.com/pratikmane0112/telmedsphere

docker dwoc flask iwoc2025 jitsi kwoc mongodb open-source reactjs stripe swoc tailwindcss

Last synced: 4 days ago
JSON representation

_____💞A telemedicine healthcare platform for doctors & patients 💞____ ◾◾◾◾◾◾◾◾◾◾◾◾◾ 🎊 Open for contributions. Please follow me, ⭐ the repo, fork it & start your contribution👨‍💻 Happy Coding !!!!! 🎊

Awesome Lists containing this project

README

        

#

💖TelMedSphere


[![Open Source Love svg1](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)
![Visitors](https://api.visitorbadge.io/api/visitors?path=PratikMane0112%2FTelMedSphere%20&countColor=%23263759&style=flat)
![GitHub forks](https://img.shields.io/github/forks/PratikMane0112/TelMedSphere)
![GitHub Repo stars](https://img.shields.io/github/stars/PratikMane0112/TelMedSphere)
![GitHub contributors](https://img.shields.io/github/contributors/PratikMane0112/TelMedSphere)
![GitHub last commit](https://img.shields.io/github/last-commit/PratikMane0112/TelMedSphere)
![GitHub repo size](https://img.shields.io/github/repo-size/PratikMane0112/TelMedSphere)
![Github license](https://img.shields.io/github/license/PratikMane0112/TelMedSphere)
![GitHub issues](https://img.shields.io/github/issues/PratikMane0112/TelMedSphere)
![GitHub closed issues](https://img.shields.io/github/issues-closed-raw/PratikMane0112/TelMedSphere)
![GitHub pull requests](https://img.shields.io/github/issues-pr/PratikMane0112/TelMedSphere)
![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/PratikMane0112/TelMedSphere)


🧾 Table of Contents

[📌 Introduction](#introduction).

[💡 Features](#features).

[🚀 Technology Used](#technology-used).

[⭐ Overview](#overview).

[💥 Getting Started](#getting-started).

[🐳 Docker Setup](#docker-setup).

[⚡ Project Admin & Mentors](#project-admin-and-mentors).

[💬 Join Chatting Server](#contributing-with-fun).

[📑 Contributing Guidelines](#contributing-guidelines).

[📑 Code Of Conduct](#code-of-conduct).

[📑 License](#license).


📌Introduction

TelMedSphere is designed to make healthcare simple and accessible for both doctors and patients. It allows patients to connect with doctors through video calls, manage their health records, and make payments easily. For doctors, the app provides tools to schedule consultations, write prescriptions, and manage their time effectively.

💡Features

🚨 For Patients:

- Book Video Calls: Easily schedule video consultations with doctors.
- Share Feedback: Rate and review the doctor after your consultation.
- Manage Your Profile: Update and view your personal details.
- View Past Records: Check previous orders and prescriptions in one place.
- Easy Payments: Use the wallet feature powered by Stripe for secure payments.

🚨 For Doctors:

- Set Up Your Profile: Add information about yourself and your services.
- Manage Availability: Set your working hours for consultations.
- Join Video Calls: Connect with patients at the scheduled time.
- Write Prescriptions: Share prescriptions directly with patients after the consultation.
- Queue System: Organize appointments efficiently with a smart queue feature.

🚀Technology Used


HTML
CSS
JS
React
SCSS
Python
Flask
Mongo
Docker

🚨 Frontend: ReactJs

🚨 Styling: TailwindCSS

🚨 Backend: Python, Flask

🚨 Database: MongoDB Atlas

🚨 Containerization: Docker

⭐Overview

Live Project Demo ↗️

![](https://github.com/PratikMane0112/TelMedSphere/blob/master/Overview/1.png)
![](https://github.com/PratikMane0112/TelMedSphere/blob/master/Overview/2.png)
![](https://github.com/PratikMane0112/TelMedSphere/blob/master/Overview/3.png)
![](https://github.com/PratikMane0112/TelMedSphere/blob/master/Overview/4.png)
![](https://github.com/PratikMane0112/TelMedSphere/blob/master/Overview/5.png)
![](https://github.com/PratikMane0112/TelMedSphere/blob/master/Overview/6.png)

⬆️

💥Getting Started

- Fork this Repository.
- Clone the forked repository in your local system.

```bash
git clone https://github.com//TelMedSphere.git
```

💻Local Setup

- Navigate to the project directory for frontend Setup.

```bash
# Navigate to frontend directory
cd frontend
# Install all npm packages for react frontend
# Use `npm ci` to avoid changing package-lock.json after every install https://stackoverflow.com/a/56254478
npm ci
# Set .env file
copy .env.example .env
# (For linux) cp .env.example .env
# Start the frontend
npm run dev
```

- Navigate to the project directory for backend Setup.

```bash
# Navigate to backend directory
cd backend
# Set .env file
copy .env.example .env
# (For linux) cp .env.example .env
# Create a virtual environment
python -m venv venv # This will create a folder named venv inside your project directory
# Activate the virtual environment
venv\Scripts\activate
# Install all dependencies for flask server
pip install -r requirements.txt
# Run flask server
flask run
# deactivate the virtual environment, when you are done
deactivate
```
- Navigate to the project directory for ML model Setup.

```bash
# Navigate to backend directory
cd models
# Create a virtual environment
python -m venv venv # This will create a folder named venv inside your project directory
# Activate the virtual environment
venv\Scripts\activate
# Install all dependencies for flask server
pip install -r requirements.txt
# Run flask server
flask run
#update the development server link in .env file of frontend(MODEL_URL)
# deactivate the virtual environment, when you are done
deactivate
```

## How to Get `.env` File Variables

Refer to the [EnvVarSetUpGuideline.md](.github/EnvVarSetUpGuideline.md) for detailed steps on setting up the `.env` files for both the frontend and backend.

⬆️

🐳Docker Setup

Docker provides an easier way to set up and run TelMedSphere with all its dependencies.

### Prerequisites
- Docker and Docker Compose [installed](https://www.docker.com/products/docker-desktop/) on your system
- Environment variables ready for configuration

### Steps to Run with Docker

1. Clone the repository same as above:

2. Update Enviroment variables:
- Update Environment variables mentioned in docker-compose based on each project's `.env` respectively

3. Start the application using Docker Compose:
```bash
docker-compose up --build -d
```

The application will be available at:
- Frontend: http://localhost:3000
- Backend: http://localhost:5000

### Stopping the Application
```bash
docker-compose down
```

### Remove the Container
```bash
docker-compose kill
```

⬆️

⚡Project Admin and Mentors

Pratik Mane
Project Admin - Pratik Mane

Pratik Mane
KWoC Mentor - Harshwardhan Patil

Pratik Mane
SWoC Mentor - Aditya Bavadekar

Raj Khanke
DWoC Mentor - Raj Khanke

🚩 Project is part of below Open Source Programs

KWOC2024
KWoC 2k24


SWOC2025
SWoC 2k25



SWOC2025
DWoC 2k25


IWOC2025
IWoC 2k25

🫂Project Contributors



🧡Contributing with fun

[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com)

Join Discord Server↗️

📑Contributing Guidelines

Read our [Contributing Guidelines](https://github.com/PratikMane0112/TelMedSphere/blob/master/.github/CONTRIBUTING_GUIDELINES.md) to learn about our development process, how to propose bugfixes and improvements, and contributions.

📑Code Of Conduct

TelMedSphere and everyone participating in it is governed by the [Code of Conduct](https://github.com/PratikMane0112/TelMedSphere/blob/master/.github/CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.

🧾License

This project is licensed under the Apache License 2.0. See the [LICENSE](https://github.com/PratikMane0112/TelMedSphere/blob/master/LICENSE) file for more details.

```
Copyright 2025 Pratik Mane

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```