Random Indian Name Generator

A high-quality, lightweight Node.js module that uses a Syllable Graph Engine to generate authentic Indian names.

Instead of random letters, this module uses real cultural "roots" and "transitions" to ensure names are phonetically natural, unique, and accurate.

Features

• TypeScript Ready: Fully typed with type definitions.
• Generative Algorithm: Infinite variety, no stale datasets.
• Length Control: Specify min and max character counts.
• Lightweight: Zero dependencies.

Installation

npm install random-indian-names

Usage

Simple Name

Generate a random name with default length (3 to 10 characters).

const { getRandomName } = require('random-indian-names');

// Generate a random name (3 to 10 characters default)
console.log(getRandomName()); // e.g., "Arjun"

TypeScript / ES Modules

import { getRandomName } from 'random-indian-names';

// Generate a random name
console.log(getRandomName(5, 10)); // e.g., "Vihaan"

With Length Constraints

// Get a name between 3 and 5 characters
console.log(getRandomName(3, 5)); // e.g., "Aditi"

// Call with one parameter (min=5, max defaults to 10)console.log(getRandomName(8)); // e.g., "Ishaninath"

API

getRandomName(min, max)

• min (Number): Minimum character length (default: 3, minimum: 3).
• max (Number): Maximum character length (default: 10, maximum: 15).
• Returns: A capitalized string. (e.g., "Sania").

[!NOTE] For quality reasons, the module restricts names to a maximum of 15 characters.

License

MIT