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

https://github.com/arulkumarann/heart-disease-prediction


https://github.com/arulkumarann/heart-disease-prediction

Last synced: about 1 year ago
JSON representation

Awesome Lists containing this project

README

          

# Heart Disease Prediction App

This is a simple web application for predicting heart disease using FastAPI for the backend and MongoDB for data storage.

## Features

- Collects user input for heart disease prediction.
- Stores user data in MongoDB.
- Provides predictions based on the user input.

## Requirements

- Python 3.6+
- MongoDB

## Installation

1. Clone the repository:

```bash
git clone https://github.com/arul-5/heart-disease-prediction.git
## Project Setup

1. **Navigate to the project directory:**

```bash
cd heart-disease-prediction
```

2. **Create a virtual environment (optional but recommended):**

```bash
python -m venv venv
```

3. **Activate the virtual environment:**

- On Windows:

```bash
venv\Scripts\activate
```

- On macOS and Linux:

```bash
source venv/bin/activate
```

4. **Install dependencies:**

```bash
pip install -r requirements.txt
```

5. **Create a .env file in the project root directory and add your MongoDB connection URL:**

```bash
DATABASE_URL=mongodb://username:password@host:port/database_name
```

Replace `username`, `password`, `host`, `port`, and `database_name` with your MongoDB connection details.

## Running the Application

1. **Start the FastAPI server:**

```bash
uvicorn main:app --reload
```

The server will start running on [http://localhost:8000](http://localhost:8000).

2. **Open your web browser and navigate to [http://localhost:8000/docs](http://localhost:8000/docs) to access the FastAPI autogenerated documentation.**

3. **Use the provided forms in the documentation to interact with the API, fill out the form, and submit to see the prediction.**

## Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue for bug fixes, feature requests, or improvements.