PHPackages                             haltuf/genderer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. haltuf/genderer

ActiveLibrary

haltuf/genderer
===============

Independent library to detect gender by name in Czech. Also returns 5th grammatical case (vocative) for salutation.

v0.3(5y ago)33229.3k↓28.3%8[1 PRs](https://github.com/haltuf/genderer/pulls)BSD-3-ClausePHPPHP >=5.3.1

Since Apr 16Pushed 2y ago2 watchersCompare

[ Source](https://github.com/haltuf/genderer)[ Packagist](https://packagist.org/packages/haltuf/genderer)[ RSS](/packages/haltuf-genderer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (1)Versions (4)Used By (0)

Genderer
========

[](#genderer)

[![Build Status](https://github.com/haltuf/genderer/actions/workflows/ci.yml/badge.svg)](https://github.com/haltuf/genderer/actions/workflows/ci.yml/badge.svg) [![Coverage Status](https://camo.githubusercontent.com/c01bac489ac9f9d64371760361aa46f68cafd16ea1f5de3f702e602696aaf478/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f68616c7475662f67656e64657265722f62616467652e737667)](https://coveralls.io/r/haltuf/genderer)

Independent library to detect gender by name in Czech language. Also provides 5th grammatical case (vocative) for salutation. Nezávislá knihovna pro detekci pohlaví podle jména. Kromě toho je schopna dle zadaného jména vrátit 5. pád pro oslovení.

See `example.php` for example of use.

Please be patient, this is my first github project and I use it as a testing playground.

Versions
--------

[](#versions)

List of current versions:

StatusVersionComposerPHPstable0.3~0.3>= 5.3, <= 8.0stable0.2~0.2>= 5.3, <= 7.3stable0.1~0.1>= 5.3, <= 7.1Requirements
------------

[](#requirements)

- PHP 5.3.1 or higher
- Sqlite3 extension
- mbstring extension

The library was written as a standalone tool with zero dependencies to other projects. This way you can use it in any project or framework you like. If you want to use it in combination with Nette Framework, check out [GenderHelper](https://www.github.com/haltuf/gender-helper).

Installation
------------

[](#installation)

Easiest way to install is through composer

```
composer require haltuf/genderer

```

Usage
-----

[](#usage)

```
use Haltuf\Genderer\Genderer ;

$g = new Genderer ;

// Dobrý den, Tomáši Vomáčko
echo "Dobrý den, " . $g->getVocative("Tomáš Vomáčka");

// 'm' = male, 'f' = female
echo "Pohlaví: " . $g->getGender("Tomáš Vomáčka");

// Dobrý den, MUDr. Tomáši Amosi Březino
echo "Dobrý den, " . $g->getVocative("MUDr. Tomáš Amos Březina");
```

Data source
-----------

[](#data-source)

The database of names comes from [Trixi blog](http://blog.trixi.cz/2012/08/5-pady-vsech-jmen-osob-v-cr-volne-ke-stazeni/) and is a compilation of the government oficial database (MVCR) and the contribution of authors working on [validace.cz](http://www.validace.cz) project.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity45

Moderate usage in the ecosystem

Community14

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1109 days

Total

3

Last Release

1832d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e01053ba7aad458d64551f8bb00db83276040efbe4ebbdd05d8f2f2c85b0467b?d=identicon)[haltuf](/maintainers/haltuf)

---

Top Contributors

[![haltuf](https://avatars.githubusercontent.com/u/325759?v=4)](https://github.com/haltuf "haltuf (39 commits)")[![jbrada](https://avatars.githubusercontent.com/u/7402947?v=4)](https://github.com/jbrada "jbrada (1 commits)")[![mlutonsky](https://avatars.githubusercontent.com/u/423848?v=4)](https://github.com/mlutonsky "mlutonsky (1 commits)")

---

Tags

namegenderczechsalutation

### Embed Badge

![Health badge](/badges/haltuf-genderer/health.svg)

```
[![Health](https://phpackages.com/badges/haltuf-genderer/health.svg)](https://phpackages.com/packages/haltuf-genderer)
```

###  Alternatives

[ondrs/hi

Czech names and surnames greeting generator API PHP wrapper

3965.9k](/packages/ondrs-hi)[adci/full-name-parser

Parses a human name

29714.4k5](/packages/adci-full-name-parser)[movemoveapp/laravel-dadata

Laravel SDK for working with the DaData.RU service API

45209.8k](/packages/movemoveapp-laravel-dadata)[hosmelq/name-of-person

Presenting names of people in full, familiar, abbreviated, and initialized forms

11121.8k](/packages/hosmelq-name-of-person)[heureka/inflection

Czech inflection library

6163.9k](/packages/heureka-inflection)[mikulas/inflection

Czech inflection library

2959.1k](/packages/mikulas-inflection)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)