Algiers HNO is a website that will find the hospital with the specifications you require for in Algiers and give you the shortest path to it. This is an Intro. to AI school project proposed by Mr. Ahmed GUESSOUM at the Higher National School of AI (ENSIA)
- Python 3.8+
- Node.js 16+ and npm
- Conda (Anaconda or Miniconda)
Port numbers and API endpoints are centralized in constants files:
- Frontend:
client/src/constants/config.ts - Backend:
server/src/constants.py - Root:
constants.js(for shared reference)
Default ports:
- Backend: 5001
- Frontend: 3000
Using conda:
conda create -n Algiers-HNO python=3.8
conda activate Algiers-HNOOr using venv:
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activatecd server
pip install -r requirements.txtcd ../client
npm installYou need to run both the backend and frontend servers. Open two terminal windows:
# Activate your environment
conda activate Algiers-HNO # or source .venv/bin/activate
# Start the backend server
cd server/src
python app.pyThe backend server will run on http://localhost:5001
# Start the frontend development server
cd client
npm run devThe frontend will run on http://localhost:3000
Open your browser and navigate to http://localhost:3000 to use the application.
Algiers-HNO/
├── client/ # Next.js frontend application
│ └── src/
│ └── constants/
│ └── config.ts # Frontend constants
├── server/ # Flask backend API
│ ├── src/ # Python source files
│ │ └── constants.py # Backend constants
│ └── data/ # Data files
├── constants.js # Shared constants reference
├── image/ # README images
└── cache/ # Cache directory
- We are working on providing a better user experience
- Expanding the project to serve all states of Algeria is put into consideration
- Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.