# persian-tools/persian-tools

A comprehensive, high-performance TypeScript toolkit for Persian (Farsi) text, numbers, validation, and locale utilities — works in Node.js, Bun, and the browser.

Repository: https://github.com/persian-tools/persian-tools
Canonical: https://ross.abutalabs.com/products/persian-tools
Homepage: https://persian-tools.usestrict.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: number-to-words, words-to-numbers, verify-bank-nunber, iranian-national-id, verify-national-id, persian-language, persian-characters, iban, sheba, card-number, code-melli, fuzzy-matching, convert-numbers, remove-commas, convert-persian-number, sheba-validator, persian-words-to-number, code-melli-validator, english-number-to-persian
Last push: 2026-07-23T19:38:16+00:00

## Health v2 (maintenance only)
Score: 72/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 94, release rhythm 28, longevity 100
- inputs: {"age_days": 2998, "days_push": 41, "days_rel": 269, "gap_med": 180.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1210, forks 131 (observed 2026-08-28T04:03:59.880673+00:00)

## What it is
A comprehensive, zero-dependency TypeScript toolkit with 27+ utilities for Persian (Farsi) text, numbers, and Iranian-specific validation such as national IDs, bank cards, and IBAN/Sheba. It is library-agnostic, tree-shakable, and runs in Node.js, Bun, and modern browsers.

## Use cases
- convert persian numbers to words and back
- validate iranian national id (code melli)
- validate iranian bank card numbers and identify the bank
- validate iban/sheba account numbers
- convert persian arabic english digits
- format numbers with thousands separators in farsi apps
- validate iranian phone numbers and detect operator
- parse iranian vehicle license plates

## When to choose
- building any Persian-language web or Node.js app needing number/text utilities
- validating Iranian national IDs, phone numbers, bank cards, or Sheba/IBAN in forms
- you need a lightweight, tree-shakable, typed library with no dependencies

## When to avoid
- you need full NLP like stemming or machine translation for Persian
- your project is not JavaScript/TypeScript based
- you only need locale formatting already covered by Intl APIs

## Facets
- artifact type: library
- maturity: active
- function: nlp, serialization, form-handling
- domain: fintech, web-development, developer-tools
- platform: bun, browser, cross-platform
- tags: persian, farsi, iranian-national-id, sheba-iban, bank-card-validation, number-to-words, digit-conversion, tree-shakable, zero-dependencies, natural-language-processing, localization, nodejs, typescript

## Member repositories
- persian-tools/persian-tools (main) score 72

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:59.880673+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:18:32.267048+00:00, confidence not recorded.
  - readme: https://github.com/persian-tools/persian-tools (fetched 2026-08-28T04:03:59.880673+00:00, sha 26d109efbd71)
  - homepage: https://persian-tools.usestrict.dev (fetched 2026-08-29T12:26:27.691758+00:00, sha c15b8508553b)
  - site_page: https://persian-tools.usestrict.dev/getting-started/installation (fetched 2026-08-29T12:26:27.702053+00:00, sha 3c25fe3dc1f4)
  - site_page: https://persian-tools.usestrict.dev/getting-started/usage (fetched 2026-08-29T12:26:27.704907+00:00, sha 09f694a69fc1)
  - site_page: https://persian-tools.usestrict.dev/getting-started/examples (fetched 2026-08-29T12:26:27.707770+00:00, sha f300f5cbfa25)
- Data as of 2026-08-30T08:39:29.467469+00:00.