hrstreamline

A Human Resource Management System (HRMS) designed to streamline core HR processes and improve employee management within organizations. This system focuses on managing employee data, tracking leave requests, and automating essential HR tasks to enhance operational efficiency and employee experience.

Live Demo

• AI Assistant for reporting: https://aihrstreamline-dthatprince.streamlit.app/
• API & Documentation: https://dthatprince-hrstreamline-api.onrender.com/

Installation & Setup

1. Clone the Repository

git clone https://github.com/dthatprince/hrstreamline.git
cd hrstreamline

2. Create & Activate Virtual Environment

python -m venv venv
source venv/bin/activate  # Mac/Linux
venv\Scripts\activate  # Windows

3. Install Dependencies

pip install -r requirements.txt

4. Run the Application

flask db init
flask db migrate -m "Initial migration"
flask db upgrade

5. Run the Application

flask --app app --debug run

The application will run at http://127.0.0.1:5000/

6. Run the AI HR Assistant Streamli Application

cd ai_hr_assistant
streamlit run main.py

The application will run at http://localhost:8501/

Start the app with Docker Compose

docker-compose up --build

The app will be available at: http://localhost:5000

Manual Development

Start Redis (locally):

redis-server

Start Celery Worker:

celery -A celery_worker.celery worker --loglevel=info

Start Celery Beat:

celery -A celery_worker.celery beat --loglevel=info

Or combined:

celery -A celery_worker.celery worker --beat --loglevel=info