Hanzo Personas

712 personality profiles for AI agents, grounded in personality psychology.

Install

npm install @hanzo/personas

Usage

import { list, get, getProfile, getPersonaMd } from '@hanzo/personas'

// List all 712 persona slugs
const slugs = list()

// Load a persona (profile.json + PERSONA.md)
const feynman = get('feynman')
console.log(feynman.profile.ocean)  // { openness: 95, ... }
console.log(feynman.persona)         // "---\nname: Feynman\n..."

// JSON profile only
const linus = getProfile('linus')

// PERSONA.md only
const md = getPersonaMd('north-star')

Structure

Each persona lives in personas/<slug>/:

personas/
  ada/
    profile.json    # compact JSON (OCEAN 0-100, tools, philosophy)
    PERSONA.md      # rich prose (Big Five 0.0-1.0, 30 NEO PI-R facets, quirks)
  feynman/
    profile.json
    PERSONA.md
  linus/
    profile.json    # JSON-only personas (no PERSONA.md yet)

712 total — 14 have deep PERSONA.md files, all have JSON profiles.

profile.json

{
  "id": "feynman",
  "name": "Richard Feynman",
  "category": "pioneer",
  "ocean": { "openness": 95, "conscientiousness": 72, "extraversion": 80, "agreeableness": 50, "neuroticism": 30 },
  "philosophy": "If you can't explain it simply, you don't understand it",
  "tools": { "essential": ["read", "write", "think"], "domains": ["physics", "pedagogy"] }
}

PERSONA.md

Rich persona with 30 NEO PI-R trait facets, HEXACO honesty-humility, productive role mapping, cognitive style, working patterns, values, and documented quirks sourced from primary materials.

See personas/feynman/PERSONA.md for an example.

Categories

Category Count Examples
Pioneers 12 Ada Lovelace, Grace Hopper, Alan Turing
Language creators 20 Guido van Rossum, Yukihiro Matsumoto
Systems 15 Linus Torvalds, Ken Thompson
AI/ML 15 Geoffrey Hinton, Yann LeCun
Web 15 Tim Berners-Lee, Brendan Eich
Security 10 Bruce Schneier, Phil Zimmermann
Thinkers 300+ Feynman, Tesla, Dijkstra, Jobs
Archetypes 5 North Star, Engineer, Analyst, Mentor, Creative
Real people 1 Zeekay

Framework

For loaders (Rust, TypeScript, Python), schemas, and validation tools see @hanzo/persona.

Research basis

  • Big Five (Costa & McCrae, 1992) — OCEAN traits
  • NEO PI-R (Costa & McCrae, 1992) — 30 facet subscales
  • HEXACO (Ashton & Lee, 2007) — Honesty-Humility factor
  • Belbin team roles (1981) — productive role mapping

License

MIT

S
Description
Named persona profiles with authored personality trait data for AI characters.
Readme
5.7 MiB
Languages
TypeScript 87.4%
Go 12.6%