{"id":28377008,"url":"https://github.com/bellingcat/alias-generator","last_synced_at":"2025-06-26T18:32:11.892Z","repository":{"id":182297999,"uuid":"668210334","full_name":"bellingcat/alias-generator","owner":"bellingcat","description":"Node module to generate likely aliases for a given human name","archived":false,"fork":false,"pushed_at":"2023-08-04T10:29:43.000Z","size":114,"stargazers_count":20,"open_issues_count":8,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-05-30T00:42:04.767Z","etag":null,"topics":["alias","generator","javascript","nodejs","open-source-research"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@bellingcat/alias-generator","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bellingcat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-07-19T09:24:24.000Z","updated_at":"2025-04-27T15:42:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"418a8153-906e-4a43-b109-eba24acae5f7","html_url":"https://github.com/bellingcat/alias-generator","commit_stats":null,"previous_names":["bellingcat/alias-generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bellingcat/alias-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bellingcat%2Falias-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bellingcat%2Falias-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bellingcat%2Falias-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bellingcat%2Falias-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bellingcat","download_url":"https://codeload.github.com/bellingcat/alias-generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bellingcat%2Falias-generator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262122823,"owners_count":23262481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alias","generator","javascript","nodejs","open-source-research"],"created_at":"2025-05-30T00:39:03.446Z","updated_at":"2025-06-26T18:32:11.833Z","avatar_url":"https://github.com/bellingcat.png","language":"JavaScript","readme":"# alias-generator\n\nNode module to generate likely aliases for a given human name.\n\n## Usage\n\nIn node\n```\nimport getAliases from '@bellingcat/alias-generator';\n\nlet list = getAliases(\"William Randolph Hearst\");\nconsole.log(list);\n```\n\nIn the browser\n```\n\u003cscript src=\"node_modules/@bellingcat/alias-generator/dist/main.js\"\u003e\u003c/script\u003e\n\u003cscript\u003e\n\n  let list = aliasGenerator.getAliases(\"William Randolph Hearst\");\n  console.log(list);\n\n\u003c/script\u003e\n```\n\nOutput:\n\n```\n[\n  'william hearst',\n  'hearst, william',\n  'william randolph hearst',\n  'hearst, william randolph',\n  'william r hearst',\n  'hearst, william r',\n  'w hearst',\n  'w randolph hearst',\n  'w r hearst',\n  'wr hearst'\n]\n```\n\n## Considerations\n\nWhen generating name variants, many considerations apply and may be culturally specific. See https://en.wikipedia.org/wiki/Personal_name\n\n**Initials** may be substituted for first or middle names, and middle names may be omitted.\n\nExample: The name \"Alfred Jodocus Kwak\" may appear online as any of the following equivalents:\n * Alfred Kwak\n * Alfred J. Kwak\n * AJ Kwak\n * A. J. Kwak\n * Kwak, Alfred J\n * Al Kwak\n\n**Name order** is culturally specific: East Asian names are often written surname-givenname instead of the western style of givenname-surname, not to mention in a different character sets:\n\nExample: Hayao Miyazaki\n * Miyazaki Hayao\n * 宮崎 駿\n\n**Patronyms/matronyms** (names derived from the given name of a parent) may appear before, after, or in place of a surname.\n\nExample: Abel Janszoon Tasman (\"Abel, son of Jan Tasman\")\n * Abel Tasman\n * Abel Janszoon\n\n**Shortened or diminuitive** versions of a name may exist and are culturally specific.\n\nExample: Mike for Michael, Bill for William, Bob for Robert in the West. Katya for Ekaterina in Eastern Europe.\n\n**Marriage** may result in surname changes, hyphenation or combination of one's original name(s).\n\n**Tussenvoegsels** in Dutch names such as \"van der Laan\" may be abbreviated \"v.d. Laan\"\n\n\n## Possibly Helpful Libraries\n* https://nameparser.readthedocs.io/en/latest/ (python)\n* https://github.com/theiconic/name-parser (php)\n* https://github.com/berkmancenter/namae (ruby)\n* https://github.com/carltonnorthern/nicknames (python)\n* https://www.nameapi.org/en/demos/name-parser/\n* https://searchgizmos.com/generate-and-search-for-name-variants-with-carls-name-net/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbellingcat%2Falias-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbellingcat%2Falias-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbellingcat%2Falias-generator/lists"}