hrms is a free, open source human resources (hr) project written in Python and released under GPL-3.0. It has 8,799 GitHub stars, 2,708 forks and 472 open issues, and was last pushed 13 hours ago. On this registry it ranks #1 of 4 tracked projects in Human Resources (HR), with 5 head-to-head comparisons available. It gained 6 stars over the last 3 tracked days.

What is hrms?

What it is

Frappe HR is an open-source Human Resources and Payroll application built and maintained by the Frappe team. It ships as a complete HRMS with over thirteen modules covering employee management, onboarding, leave, payroll, taxation, and more, and it runs on the Frappe Framework, a full-stack web application framework written in Python and JavaScript that provides a database abstraction layer, user authentication, and a REST API. The interface is built with Frappe UI, a Vue-based component library for single-page applications. The project is distributed under the GPL-3.0 license and lives in the ERPNext ecosystem, where it integrates directly with ERPNext accounting.

The concrete problem it solves is the absence of a genuinely open-source HR and payroll system. The Frappe team started building it when their own headcount grew and they could not find any "true" open-source HR software to run. The modules began life inside ERPNext, and from version 14 onward, once they had matured, Frappe HR was split out as a standalone product. It gives organizations an HR platform they can host, inspect, and extend rather than license.

Key capabilities

  • Employee lifecycle management covering onboarding, promotions, transfers, feedback, and exit interviews.
  • Leave and attendance administration with configurable leave policies, one-click regional holiday import, and geolocation-captured check-in and check-out.
  • Leave balance and attendance tracking with reporting.
  • Expense claims and employee advances with configurable multi-level approval workflows and integration into ERPNext accounting.
  • Performance management with goal tracking, alignment to key result areas (KRAs), employee self-evaluation, and appraisal cycles.
  • Payroll and taxation with salary structures, income tax slabs, standard payroll runs, additional and off-cycle payments, and income breakup on salary slips.
  • A Frappe HR mobile app for applying for and approving leave, checking in and out, and viewing employee profiles.

Who uses it and how

  • Organizations that need payroll, taxation, and leave administration in one system rather than several disconnected tools.
  • Companies already running ERPNext that want employee expenses, advances, and accounting to stay in the same system.
  • HR teams managing the full employee lifecycle, from onboarding through promotions and transfers to exit interviews.
  • Managed-hosting customers who deploy through Frappe Cloud, which handles installation, setup,
project readme (upstream, from github) — read inline

Frappe HR

Open Source, modern, and easy-to-use HR and Payroll Software

CI codecov

frappe%2Fhrms | Trendshift

Website - Documentation

Frappe HR

Frappe HR has everything you need to drive excellence within the company. It's a complete HRMS solution with over 13 different modules right from Employee Management, Onboarding, Leaves, to Payroll, Taxation, and more!

Motivation

When Frappe team started growing in terms of size, we needed an open-source HR and Payroll software. We didn't find any "true" open-source HR software out there and so decided to build one ourselves. Initially, it was a set of modules within ERPNext but version 14 onwards, as the modules became more mature, Frappe HR was created as a separate product.

Key Features

  • Employee Lifecycle: From onboarding employees, managing promotions and transfers, all the way to documenting feedback with exit interviews, make life easier for employees throughout their life cycle.
  • Leave and Attendance: Configure leave policies, pull regional holidays with a click, check-in and check-out with geolocation capturing, track leave balances and attendance with reports.
  • Expense Claims and Advances: Manage employee advances, claim expenses, configure multi-level approval workflows, all this with seamless integration with ERPNext accounting.
  • Performance Management: Track goals, align goals with key result areas (KRAs), enable employees to evaluate themselves, make managing appraisal cycles easy.
  • Payroll & Taxation: Create salary structures, configure income tax slabs, run standard payroll, accommodate additional salaries and off cycle payments, view income breakup on salary slips and so much more.
  • Frappe HR Mobile App: Apply for and approve leaves on the go, check-in and check-out, access employee profile right from the mobile app.
View Screenshots

Under the Hood

  • Frappe Framework: A full-stack web application framework written in Python and Javascript. The framework provides a robust foundation for building web applications, including a database abstraction layer, user authentication, and a REST API.

  • Frappe UI: A Vue-based UI library, to provide a modern user interface. The Frappe UI library provides a variety of components that can be used to build single-page applications on top of the Frappe Framework.

Production Setup

Managed Hosting

You can try Frappe Cloud, a simple, user-friendly and sophisticated open-source platform to host Frappe applications with peace of mind.

It takes care of installation, setup, upgrades, monitoring, maintenance and support of your Frappe deployments. It is a fully featured developer platform with an ability to manage and control multiple Frappe deployments.

Try on Frappe Cloud
</a>

Development setup

Docker

You need Docker, docker-compose and git setup on your machine. Refer Docker documentation. After that, run the following commands:

git clone https://github.com/frappe/hrms
cd hrms/docker
docker-compose up

Wait for some time until the setup script creates a site. After that you can access http://localhost:8000 in your browser and the login screen for HR should show up.

Use the following credentials to log in:

  • Username: Administrator
  • Password: admin

Local

  1. Set up bench by following the Installation Steps and start the server and keep it running
    $ bench start
    
  2. In a separate terminal window, run the following commands
    $ bench new-site hrms.localhost
    $ bench get-app erpnext
    $ bench get-app hrms
    $ bench --site hrms.localhost install-app hrms
    $ bench --site hrms.localhost add-to-hosts
    
  3. You can access the site at http://hrms.localhost:8080

Learning and Community

  1. Frappe School - Learn Frappe Framework and ERPNext from the various courses by the maintainers or from the community.
  2. Documentation - Extensive documentation for Frappe HR.
  3. User Forum - Engage with the community of ERPNext users and service providers.
  4. Telegram Group - Get instant help from the community of users.

Contributing

  1. Issue Guidelines
  2. Report Security Vulnerabilities
  3. Pull Request Requirements

Logo and Trademark Policy

Please read our Logo and Trademark Policy.



Frappe Technologies
</a>

Frequently asked questions

Is hrms free to use?

hrms is open source under the GPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does hrms do?

Open Source HR and Payroll Software

What is hrms written in?

hrms is primarily written in Python. Its source is publicly available at https://github.com/frappe/hrms, and it has 8,799 GitHub stars.