If you build apps for the Indian market, you've probably needed mock demographic data for testing, UI previews, or training ML models.
And if you've used standard mock-data generators, you've probably ended up with a profile that looks something like this: A Sikh person named Mohammed Sharma living in Mizoram. 😅
Most fake-data libraries generate impossible demographic combinations because they operate on simple random selection. They pick a first name from list A, a last name from list B, a religion from list C, and a state from list D.
When context matters, that bad data can ruin your testing environment. That’s why I built indian-fakedata
.
{
"id": "33553413-2014-4616-9361-511204427271",
"firstName": "Pushpa",
"lastName": "Sharma",
"fatherName": "Santosh Sharma",
"motherName": "Geeta Sharma",
"spouseName": "Sanjay Sharma",
"gender": "female",
"age": 34,
"dateOfBirth": "1992-06-11",
"bloodGroup": "O+",
"heightCm": 152.9,
"weightKg": 65.9,
"bmi": 28.2,
"aadhaarNumber": "500233102039",
"panNumber": "EKIPS1361G",
"voterIdNumber": "MHR3140140",
"phoneNumber": "7513110431",
"email": "pushpasharma328@gmail.com",
"state": "Maharashtra",
"stateCode": "MH",
"district": "Aurangabad",
"areaType": "urban",
"addressLine": "469/A, Adarsh Colony, Aurangabad",
"locality": "Adarsh Colony",
"pinCode": "418683",
"religion": "Hindu",
"caste": "Deshastha Brahmin",
"socialCategory": "General",
"motherTongue": "Marathi",
"secondLanguage": "English",
"education": "secondary",
"occupation": "agricultural_labourer",
"employmentSector": "self_employed",
"maritalStatus": "married",
"annualIncomeINR": 194000,
"monthlyExpenditureINR": 15300,
"numberOfChildren": 1,
"dietaryPreference": "non_vegetarian",
"disability": "none",
"isMigrant": true,
"migrationOriginState": "Kerala",
"bankIFSC": "PUNB0314300",
"bankName": "Punjab National Bank",
"bankAccountNumber": "03131130413",
"rationCardType": "APL",
"healthInsurance": "none",
"landOwnershipAcres": 0,
"vehicleRegistration": "MH 01 BG 3908",
"vehicleType": "four_wheeler",
"hasInternetAccess": true,
"hasSmartphone": true,
"usesSocialMedia": true,
"upiId": "pushpa@okicici",
"personality": {
"openness": 53,
"conscientiousness": 47,
"extraversion": 53,
"agreeableness": 46,
"neuroticism": 74
},
"politicalLeaning": "nationalist_right",
"religiosity": "very_religious",
"cognitiveProfile": {
"aptitudeScore": 40,
"numeracyScore": 37,
"literacyScore": 75,
"digitalLiteracyScore": 45,
"financialLiteracyScore": 93
},
"interests": {
"primarySport": "cricket",
"petPreference": "fish",
"entertainment": [
"Bollywood", "TV Serials", "Cricket Matches", "News",
"YouTube", "OTT/Netflix", "Devotional Music"
],
"readingHabit": "rare",
"musicPreference": "Bollywood",
"preferredSocialMedia": "WhatsApp"
},
"habits": {
"tobaccoUse": "none",
"alcoholUse": "none",
"exerciseFrequency": "weekly",
"avgSleepHours": 9.3,
"cooksAtHome": true,
"chronotype": "early_riser"
},
"educationDetails": {
"fieldOfStudy": null,
"institutionType": "private",
"mediumOfInstruction": "English",
"qualificationYear": 2008,
"competitiveExamPercentile": null
},
"culturalProfile": {
"entrepreneurialScore": 32,
"academicOrientation": 64,
"artisticInclination": 41,
"militaryTradition": 37,
"agriculturalRootedness": 21,
"artisanTradition": 1,
"bureaucraticOrientation": 50,
"socialActivism": 13,
"communityBonding": 67,
"migrationTendency": 24,
"careerPreference": "business_trade",
"familyStructure": "nuclear_family",
"savingsOrientation": 65,
"riskAppetite": 12
},
"householdSize": 1,
"householdAssets": {
"hasRadioTransistor": false,
"hasTelevision": true,
"hasComputer": true,
"hasPhone": true,
"hasBicycle": true,
"hasScooter": true,
"hasCar": true,
"bankingService": true,
"treatedWaterSource": true,
"latrineFacility": true,
"numberOfRooms": 2,
"roofMaterial": "concrete",
"wallMaterial": "burnt_brick",
"cookingFuel": "lpg",
"lightingSource": "electricity",
"drinkingWaterSource": "tap_treated"
},
"probabilityMetrics": {
"nationalReligionFreq": 0.8033,
"stateGivenReligionProb": 0.1032,
"casteGivenContextProb": 0.0423,
"lastNameGivenCasteProb": 0.2000,
"socialCategoryProb": 0,
"educationProb": 0.2189,
"occupationProb": 0.1800,
"jointProbability": 2.76e-05
},
"generatedAt": "2026-07-12T21:56:35.146855",
"seed": 7
}
npm install @abhay557/indian-fakedata
Requires Node.js >= 18.
pip install indian-fakedata
Requires Python 3.8+.
Both packages ship with the indian-fakedata
CLI binary. The arguments are identical across both versions!
npx @abhay557/indian-fakedata [options]
indian-fakedata [options]
Run with no arguments to display the full help menu.
| Flag | Alias | Description | Default |
|---|---|---|---|
--count <n> |
|||
-c |
|||
| Number of profiles to generate | 100 |
||
--output <path> |
|||
-o |
|||
| File path to save output | stdout | ||
--format <fmt> |
|||
-f |
|||
Output format: json , jsonl , csv |
|||
json |
|||
--seed <number> |
|||
-s |
|||
| Reproducibility seed for RNG | random | ||
--no-metrics |
|||
| Exclude probability metrics from output | included | ||
--help |
|||
-h |
|||
| Show help screen |
Filter generated profiles to specific demographic slices:
| Flag | Values |
|---|---|
--religion <string> |
|
Hindu , Muslim , Christian , Sikh , Buddhist , Jain |
|
--state <string> |
|
e.g. Maharashtra , Tamil Nadu , Punjab |
|
--gender <gender> |
|
male , female , other |
|
--caste <string> |
|
e.g. Brahmin , Maratha , Jat |
|
--socialCategory <cat> |
|
SC , ST , OBC , General |
|
--areaType <type> |
|
urban , rural |
|
--minAge <n> |
|
| Minimum age (0–100) | |
--maxAge <n> |
|
| Maximum age (0–100) | |
--education <level> |
|
illiterate , primary , secondary , graduate , etc. |
|
--occupation <sector> |
|
cultivator , other_worker , non_worker , etc. |
|
--maritalStatus <status> |
|
never_married , married , widowed , etc. |
| Flag | Description |
|---|---|
--enrich |
|
| Enable ALL enrichment layers (outcomes + narrative:all + persona) | |
--outcomes |
|
| [Layer 2] Add credit score, health risk, employment outcome, education attainment | |
--bias <0-1> |
|
Bias dial for outcome simulation. 0.0 = pure meritocracy, 1.0 = max historical discrimination. Default: 0.3 |
|
--narrative <type> |
|
[Layer 3] Generate realistic Indian text documents. Repeat for multiple types: loan_application , medical_consultation , school_enrollment , ration_card_application , hinglish_conversation , all |
|
--persona |
|
| [Layer 4] Generate LLM-ready agent persona (system prompt, beliefs, memory seeds) |
indian-fakedata -c 1000 -f csv -o profiles.csv
indian-fakedata -c 50000 -f jsonl -o tn_data.jsonl --state "Tamil Nadu" --religion Hindu
indian-fakedata -c 100 --enrich --bias 0.3 -f jsonl -o enriched.jsonl
indian-fakedata -c 5000 --outcomes --bias 0.5 --socialCategory SC -f jsonl -o sc_bias.jsonl
js
import { generate, generateEnriched } from '@abhay557/indian-fakedata';
const profiles = generate({ count: 10 });
const enriched = generateEnriched({ count: 5, includeOutcomes: true });
python
from indian_fakedata import generate, generate_enriched
profiles = generate(count=10)
enriched = generate_enriched(count=5, include_outcomes=True)
Every demographic profile, name distribution, and asset weighting is calibrated against public survey data:
source & further reading
dev.to — original article
Amazon Bedrock AgentCore Guide: Production AI Agents (2026)
I added an AI restyle step to a practical fuse bead pattern maker
GPT-5.6 Sol's file deletion isn't a bug you patch. It's proof that filtering an agent's actions doesn't contain it. Here's why, and what actually does.