Repolode
Submit
horilla

horilla/horilla-hr

Free, open-source HR management system built on Django, covering employee records, recruitment, attendance, leave, payroll and performance.

Open-source alternative to:BambooHRWorkday

View on GitHubWebsite
Stars
1,465
Forks
953
Open issues
128
Last commit
12 hours ago

What is it?

Horilla HRMS is a self-hostable human resource management system for running day-to-day HR operations in one place. It covers employee records, recruitment through onboarding and offboarding, attendance and time tracking with biometric integration, leave management with policies and approvals, payroll processing, performance reviews, asset tracking and an HR helpdesk.

The application is written in Python on Django, with HTML templates and htmx and jQuery on the front end. The project offers an official Docker image for linux/amd64 and linux/arm64, a Docker Compose setup for building from source, and a manual installation path that requires Python 3.12 to 3.14. Deployment guides cover Nginx and Gunicorn.

The repository's default branch is 2.0, which is the stable version for running Horilla. Active development happens on dev/v2.0, and contributors are asked to open pull requests against that branch. Version 1.0 receives fixes only on a case-by-case basis.

Key features

  • 01Employee records with LDAP integration
  • 02Recruitment, onboarding and offboarding workflows
  • 03Attendance tracking with biometric device support
  • 04Leave policies, approvals and balance tracking
  • 05Payroll processing with tax calculations
  • 06Performance goals, reviews and asset tracking

Use cases

  • Running HR operations for a small or mid-sized company on self-hosted infrastructure
  • Replacing spreadsheets for leave tracking and attendance records
  • Managing a hiring pipeline from job posting through onboarding
  • Giving employees an internal helpdesk for HR requests

Quick start

  1. 1

    Pull the official Docker image

    docker pull horilla/horilla-hr:2.1.5
  2. 2

    Or clone the repository and start it with Docker Compose

    docker compose up -d
  3. 3

    Open the application in your browser at localhost port 8000

Things to know

  • Requires Python 3.12, 3.13 or 3.14 for manual installation; Python 3.15 does not work yet.
  • The README recommends a full Docker-based or manual setup with environment configuration, so self-hosting takes effort.
  • Development is on the 2.0 branch; v1 is deprioritized with no guaranteed fix schedule.

Topics

#hrms#hr#django#python#payroll#recruitment#attendance#leave-management#biometrics#hr-analytics

FAQ

What is horilla-hr?
Free, open-source HR management system built on Django, covering employee records, recruitment, attendance, leave, payroll and performance. Horilla HRMS is a self-hostable human resource management system for running day-to-day HR operations in one place. It covers employee records, recruitment through onboarding and offboarding, attendance and time tracking with biometric integration, leave management with policies and approvals, payroll processing, performance reviews, asset tracking and an HR helpdesk.
Is horilla-hr free to use? What license does it have?
horilla-hr is open source under the LGPL-2.1 license. Check the license terms before using it in commercial products.
Is horilla-hr still maintained?
Actively maintained. The last commit to horilla-hr was on Oct 21, 2026.
What can I use horilla-hr for?
Running HR operations for a small or mid-sized company on self-hosted infrastructure Replacing spreadsheets for leave tracking and attendance records Managing a hiring pipeline from job posting through onboarding Giving employees an internal helpdesk for HR requests
How do I install horilla-hr?
Pull the official Docker image: docker pull horilla/horilla-hr:2.1.5 Or clone the repository and start it with Docker Compose: docker compose up -d Open the application in your browser at localhost port 8000
Where can I get horilla-hr?
The source code and installation instructions are on GitHub: https://github.com/horilla/horilla-hr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects