Home

Welcome to the Hospital-Management-System wiki! This open-source project is designed to assist small hospitals around the world. Here you'll find all the information needed to set up, run, and contribute to the project.

Table of Contents

1. Getting Started
2. Installation
3. Running the Application
4. Contributing
5. License

Getting Started

This project is built using Flask, a micro web framework written in Python. It utilizes SQLAlchemy for database operations and provides features like patient registration, appointment scheduling, and user authentication.

Prerequisites

• Python 3.6+
• pip (Python package installer)
• Virtual environment (recommended)

Installation

1. Clone the Repository:

   git clone https://github.com/ghtali/Hospital-Management-System.git
   cd Hospital-Management-System

2. Set Up a Virtual Environment:

   python3 -m venv venv
   source venv/bin/activate  # On Windows, use: .\venv\Scripts\activate

3. Install Dependencies:

   pip install -r requirements.txt

Running the Application

1. Set Environment Variables (Optional):

   If you wish to use a database other than the default SQLite, set the DATABASE_URI environment variable:

   export DATABASE_URI="mysql+pymysql://<username>:<password>@<host>:<port>/<database>"

2. Initialize the Database:

   python init_db.py

3. Run the App:

   python app.py

   Access the app in your browser at http://localhost:5000/.

Contributing

Contributions are always welcome! Here's how you can help:

• Report Bugs: Use the issue tracker to report bugs.
• Submit Fixes: Submit pull requests and improve the repo.
• Improve the Docs: Enhance this Wiki or add more documentation.

License

This project is licensed under the MIT License. See the LICENSE file for details.