explaingit

ever-co/ever-gauzy

Analysis updated 2026-07-03

3,689TypeScriptAudience · pm founderComplexity · 4/5LicenseSetup · hard

TLDR

Ever Gauzy is an open-source business management platform that replaces multiple paid tools by combining HR, payroll, CRM, project tracking, invoicing, time tracking, and hiring pipelines into one self-hosted system.

Mindmap

mindmap
  root((Ever Gauzy))
    HR and People
      Employee records
      Time off approvals
      Performance goals
      Onboarding
    Finance
      Invoicing and billing
      Expense tracking
      Multi-currency
    Time Tracking
      Desktop timer app
      Activity monitoring
      Reports
    Sales and CRM
      Sales pipeline
      Customer records
      Help center
    Tech
      TypeScript
      NestJS
      Angular
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Replace separate HR, invoicing, and project management tools with one self-hosted platform for a small agency or freelance team.

USE CASE 2

Track employee hours and generate invoices from the same system without switching between apps.

USE CASE 3

Run a complete business operations stack on your own server to avoid recurring SaaS licensing fees.

What is it built with?

TypeScriptNestJSAngularPostgreSQLElectron

How does it compare?

ever-co/ever-gauzybqplot/bqplotkirodotdev/kiro
Stars3,6893,6893,686
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardeasyeasy
Complexity4/52/53/5
Audiencepm founderdatadeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires PostgreSQL and multiple services, Docker Compose setup is provided but configuring all modules takes time.

AGPL v3, you can use and modify it freely, but if you deploy a modified version publicly, you must also share your modifications as open source.

In plain English

Ever Gauzy is an open-source business management platform that covers a wide range of functions typically spread across separate paid tools. It handles HR, payroll tracking, customer relationship management, project tasks, invoicing, expenses, time tracking, and hiring pipelines, all within a single system. The project targets companies, freelancers, agencies, and on-demand businesses that want to run these operations without licensing proprietary software. The feature list is extensive. On the HR side it covers employee records, onboarding, time off approvals, activity monitoring, and performance goals. On the financial side it handles invoicing, billing, payments, income and expense tracking, and multi-currency support. There is also a sales pipeline, a help center module, scheduling and appointments, inventory and equipment tracking, and reports across most of these areas. The platform supports multiple organizations and departments within a single installation, and it ships with role-based permissions. For day-to-day time tracking, there is a dedicated desktop timer application for Windows, Mac, and Linux. This app can run standalone or connect to a Gauzy server on a different machine. A separate all-in-one desktop app bundles the full platform locally if you want to run everything on one computer. A web-based interface is also available, and the project exposes APIs so other tools can connect to it. The codebase is written in TypeScript. You can try a live demo at demo.gauzy.co, and official downloads are available from the project website. The SaaS version at app.gauzy.co was in alpha testing at the time of the README. The project is licensed under AGPL v3, which means any modifications you deploy publicly must also be made available as open source.

Copy-paste prompts

Prompt 1
I want to self-host Ever Gauzy for a 10-person agency. What are the Docker setup steps and which environment variables do I need to configure for the database and email?
Prompt 2
Using the Ever Gauzy API, show me how to create an invoice for a client project and mark it as paid programmatically.
Prompt 3
How does Ever Gauzy handle role-based permissions? Show me how to create a custom role that can view time-tracking reports but cannot approve payroll.

Frequently asked questions

What is ever-gauzy?

Ever Gauzy is an open-source business management platform that replaces multiple paid tools by combining HR, payroll, CRM, project tracking, invoicing, time tracking, and hiring pipelines into one self-hosted system.

What language is ever-gauzy written in?

Mainly TypeScript. The stack also includes TypeScript, NestJS, Angular.

What license does ever-gauzy use?

AGPL v3, you can use and modify it freely, but if you deploy a modified version publicly, you must also share your modifications as open source.

How hard is ever-gauzy to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ever-gauzy for?

Mainly pm founder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub ever-co on gitmyhub

Verify against the repo before relying on details.