Pronounce

Diccionario de pronunciación para jerga de desarrolladores: IPA, reescritura fonética y audio para más de 1650 entradas con fuentes (kubectl, nginx, JSON).

GitHub
39
Prueba este MCPPatrocinado

Documentación

🔊 say-it · Pronounce

Deja de decir "kub-cuttle". Un comando Bash pronuncia 1,903 nombres de jerga de desarrolladores, la mayoría con una fuente citada.

GitHub stars Live site License Entries Install from VS Code Marketplace Install from Open VSX Pronounce Docs GitHub Action

🌐 pronounce.renlab.ai · 🇨🇳 中文 · 📖 Explorar · 🎯 Cuestionario · 🎤 Búsqueda por voz · 🔌 Servidor MCP · ⚙️ Acción de GitHub

say-it kubectl — terminal demo

▶ Ver el promocional de 47 segundos (con voz) · 🎯 Probar el cuestionario · 🎤 Búsqueda por voz

🚀 Pruébalo en 30 segundos

git clone https://github.com/anzy-renlab-ai/pronounce.git
cd pronounce && ./install.sh
say-it kubectl

say-it CLI demo — kubectl, YAML, TOML, Ghostty

Eso es todo. Ahora prueba say-it GIF, say-it nginx, say-it Pydantic, say-it --why JSON o say-it quiz para un desafío de 10 preguntas. Usuarios de Linux: instala espeak-ng (sudo apt install espeak-ng) y la CLI simplemente funciona. Windows: la misma CLI bajo WSL o git-bash + PowerShell. O evita la instalación y usa el navegador en pronounce.renlab.ai.

⭐ Si say-it kubectl te ahorra un momento vergonzoso en la reunión diaria — dale una estrella al repositorio. Eso anima a más desarrolladores a contribuir con su nombre de proyecto mal pronunciado favorito.

Star history

🏆 El marcador de pronunciación para desarrolladores

1,903 entradas — 1,283 tienen una fuente citable — 108 resueltas por el propio creador, 175 que la comunidad aún discute. Las famosas:

✅ Resueltas — el creador lo dijo

PalabraSe dice……noResuelto por
GIF"yif""guif" (pista de G dura)Steve Wilhite (creador), NYT 2013
nginx"engine X""n-jinx"NGINX oficial
YAML"yam-ul""yammel"yaml.org
GNU"gu-NEW" (g dura)"nu"Proyecto GNU
LaTeX"lay-tek""lay-teks"Lamport / Proyecto LaTeX
TOMLrima con "knoll""tom-el"Tom Preston-Werner (creador)
Tcl"tickle""T-C-L"John Ousterhout (creador)
awk"auk" (como el ave)"A-W-K"Aho / Weinberger / Kernighan

⚔️ Aún en disputa — ambas lecturas están en uso activo

PalabraCampamento ACampamento B
kubectl"koob-control""cube-cuddle"
SQL"sequel""S-Q-L"
JSON"JAY-son""JEE-son"
GUI"gooey""G-U-I"
JWT"yot" (según RFC 7519)"J-W-T"

Cada celda tiene IPA y audio; 1,283 también tienen una fuente citable. Explora las 1,903 entradas →

¿No estás de acuerdo con alguna? Ese es el punto — abre un PR con tu lectura y una fuente. La discusión es el conjunto de datos.

Lo que realmente obtienes

  • 1,903 entradas — 1,283 tienen una fuente citable. Etiquetadas por confianza (creator-clarified / community-consensus / contested), cada una con una URL citable cuando existe (preferimos dejarla en blanco antes que inventarla). Wilhite dijo que GIF es "yif" en los Webby Awards 2013. Crockford dice que JSON es "JAY-son" (RailsConf 2009). RFC 7519 dice que JWT es "yot". El diccionario los cita.
  • Audio con múltiples lecturas. Para palabras donde el debate es real — GIF, SQL, GUI, char, regex — la CLI encadena las alternativas después de la principal con un "o:" hablado para que escuches el debate sin mirar la terminal. --solo omite la cola una vez que lo has internalizado.
  • Una CLI de Bash, sin runtime de npm. Sin sudo, sin arranque de framework, sin sorpresas. Detecta macOS say, Linux espeak-ng/espeak o Windows PowerShell System.Speech. El repositorio también incluye una habilidad para Claude Code y un servidor MCP para que tu IA responda "¿cómo se pronuncia X?" con audio, no con una suposición fonética.
  • Una acción de GitHub nativa para documentación. Escanea el Markdown modificado por una solicitud de extracción y genera un glosario de pronunciación con fuentes en el resumen del trabajo — sin clave de API, instalación de dependencias ni solicitud de red.
  • Audio canónico en el sitio web. El sitio reproduce cada MP3 canónico confirmado primero y usa Web Speech solo como respaldo si la reproducción falla.
$ say-it --why JSON
word              JSON
ipa               /ˈdʒeɪsən/
respelling_us     jay son
confidence        contested
source            Wikipedia § Pronunciation
url               https://en.wikipedia.org/wiki/JSON#Pronunciation

¿Por qué no simplemente Google?

Porque Google te da 47 discusiones de Reddit y un clip de YouTube que tienes que desmutear. El IPA te da /ˈkuːb kənˌtroʊl/ — una referencia, no un maestro.

No necesitas una transcripción fonética. Necesitas escuchar la palabra. Dos veces. Quizás tres. Listo.

say-it incluye un diccionario mantenido por la comunidad de cómo los ingenieros realmente dicen los nombres que tropiezan a todos — y alimenta la reescritura prevista al motor de texto a voz de tu sistema operativo, para que kubectl salga como koob-control, no como lo que tu computadora adivinó de las letras.

Momentos famosos

Algunas pronunciaciones no son opiniones — los creadores las resolvieron. El diccionario cita cada una:

PalabraLecturaFuente
GIF"yif" (el creador lo dice)Steve Wilhite, Webby Awards 2013
JSON"jay-son"Douglas Crockford, RailsConf 2009
GNU"g-nu" (G dura, una sílaba)Proyecto GNU oficial
Linux"LIN-ux" (i corta, schwa)El propio Linus Torvalds
LaTeX"lay-tek" (o "lah-tek")Leslie Lamport, oficial
Django"YANG-go" (D silenciosa)FAQ de Django
Vue"viu" (una sílaba)Evan You, docs de Vue
Vite"vit" (francés para rápido)Docs de Vite
Knative"KAY-nativ" (la K es sonora)Docs de Knative
etcd"et-see-dee" (et-cetera-distributed)FAQ de etcd

Ejecuta say-it --why <word> para ver la cita cuando una entrada tiene un source_url; las entradas sin fuente se dejan en blanco en lugar de dar una URL inventada.

Instalación

brew install anzy-renlab-ai/tap/say-it   # Homebrew on macOS

O el bloque "Pruébalo en 30 segundos" de arriba. ./install.sh coloca:

  • la CLI en ~/.local/bin/say-it,
  • el diccionario de pronunciación en ~/.local/share/say-it/pronunciations.tsv,
  • si usas Claude Code, una habilidad pronounce-word en ~/.claude/skills/pronounce-word/ para que cualquier pregunta "¿cómo se dice X?" a tu IA se responda con audio en lugar de IPA,
  • la misma habilidad en ~/.agents/skills/ (Codex CLI) y ~/.kiro/skills/ (Kiro) cuando esos directorios existen — es el estándar Agent Skills entre herramientas.

Asegúrate de que ~/.local/bin esté en tu $PATH. Linux también funciona — instala espeak-ng (sudo apt install espeak-ng / brew install espeak-ng). Windows: WSL o git-bash + PowerShell. O evita la instalación por completo con la versión de navegador en pronounce.renlab.ai.

Uso

say-it kubectl                    # primary × 3, then "or: <alt>" for each alternate
say-it --solo kubectl             # primary only — silence the "or:" tail
say-it --alt GIF                  # focus on the first alternate
say-it --alt 2 GUI                # focus on the Nth alternate (1-indexed)
say-it --all SQL                  # primary AND every alternate, each repeated
say-it --no-dict kubectl          # bypass the dictionary entirely
say-it --why JSON                 # show IPA, source URL, category, confidence
say-it list                       # every word in the dictionary
say-it search redis               # grep the dictionary (case-insensitive)

say-it -n 5 Pydantic              # 5 repetitions instead of 3
say-it -r 110 Knative             # slower (110 wpm; default is 130)
say-it -o /tmp/word.aiff Postgres # save to file instead of playing
say-it --list                     # all macOS voices

La voz predeterminada de macOS es Samantha (inglés general americano); -v <voice> selecciona otra voz de macOS. Linux y Windows usan la voz en inglés de su backend detectado. El diccionario es solo de inglés general americano, por diseño.

Integración con Claude Code

Instala la habilidad de agente entre herramientas directamente con GitHub CLI:

gh skill install anzy-renlab-ai/pronounce pronounce-word

You:    kubectl 怎么读？
Claude: 🔊 (plays "koob-control" three times)
        /ˈkuːb kənˌtroʊl/ — "KOOB-control". Kelsey Hightower says it
        this way (KubeCon talk). "Cube-cuddle" is an alternate —
        try `say-it --alt kubectl` to hear it.

Una vez instalada, la habilidad pronounce-word se activa automáticamente con:

  • X 怎么读 / X 怎么发音 / 读一下 X
  • how do you pronounce X / pronounce X / how do you say X

Tu IA responde con sonido, no solo con una suposición fonética. Archivo de habilidad: skills/pronounce-word/SKILL.md.

¿No usas Claude? La misma habilidad se integra en Codex CLI (codex plugin marketplace add anzy-renlab-ai/pronounce) y Kiro (~/.kiro/skills/), y el servidor MCP cubre Claude Desktop, Cursor, Continue, Zed, Cline y otros — matriz completa en integrations/.

Add to Kiro

Acción de GitHub — guías de pronunciación para documentación

Agrega un glosario de pronunciación a cada solicitud de extracción de documentación:

- uses: actions/checkout@v7.0.1
  with:
    fetch-depth: 0
- id: pronounce
  uses: anzy-renlab-ai/pronounce@v2.28.1

Pronounce Docs escanea el Markdown/MDX modificado y escribe una tabla con cada término coincidente, su IPA, reescritura en inglés sencillo, página de audio y fuente del creador u oficial cuando esté disponible. Se ejecuta localmente desde la instantánea del repositorio: sin token, clave de API, telemetría, instalación de paquetes ni solicitud de red. Consulta la configuración completa, entradas y salidas.

Extensión de VS Code

Install from VS Code Marketplace Install from Open VSX

Pronounce demo — kubectl, YAML, Ghostty, wagmi

Pasa el cursor sobre cualquier palabra técnica en cualquier archivo — ve el IPA, escucha la pronunciación. El mismo diccionario de 1,903 entradas que la CLI, empaquetado en JSON en la compilación (costo de análisis en tiempo de ejecución cero).

# Cursor / VSCodium / Zed / Gitpod / Theia / code-server (Open VSX)
code --install-extension sayit.pronounce
# or the listing: https://open-vsx.org/extension/sayit/pronounce

Ahora también en Microsoft Marketplace: ext install sayit.pronounce en VS Code. Consulta el listado del marketplace.

  • Pasa el cursor sobre kubectl, YAML, Ghostty, wagmi… → información sobre herramientas con IPA + 🔊 Reproducir + ★ Enlace de estrella.
  • ⌘⇧' — habla la selección.
  • Barra de estado 🔊 sayit — haz clic para hablar la selección actual.
  • Tutorial de bienvenida — incorporación en 4 pasos en la primera instalación.
  • Pronounce: Search dictionary… — búsqueda difusa de las 1,903 entradas.

Fuente: integrations/vscode/. Multiplataforma desde v0.3 — macOS say, Linux espeak-ng, Windows PowerShell.

Extensión para Chrome / Edge / Brave

Haz clic en cualquier palabra técnica en cualquier página web → ventana emergente con IPA y audio. El mismo diccionario de 1,903 entradas. La extensión habla a través de Web Speech; pronounce.renlab.ai reproduce el corpus de MP3 confirmado primero y reserva Web Speech como respaldo. Solo carga lateral por ahora (aún no está en Chrome Web Store).

Descarga pronounce-chrome-0.3.1.zip → descomprime → chrome://extensions/ → Modo desarrollador → Cargar descomprimida.

Fuente: integrations/chrome/.

Cómo funciona el diccionario

data/pronunciations.tsv es la única fuente de verdad — separado por tabulaciones, 1,903 entradas, que cubren:

  • Cloud / DevOps: kubectl, nginx, Kubernetes, helm, Istio, Envoy, Prometheus, Grafana, Terraform, Argo, Knative, etcd, containerd, runc, Podman, ...
  • Lenguajes / Frameworks: Django, Vue, Vite, Pydantic, Bun, Deno, Hugo, Hono, Caddy, Svelte, Astro, Pinia, ...
  • Bases de datos: PostgreSQL, Postgres, SQLite, MySQL, MongoDB, Cassandra, Redis, Ceph, ScyllaDB, ClickHouse, DuckDB, ...
  • Jerga / acrónimos de CS: GIF, JSON, SQL, GUI, GNU, char, regex, sudo, tmux, chmod, WYSIWYG, ASCII, enum, NaN, SaaS, PaaS, ...
  • Distros / herramientas: Linux, Debian, Ubuntu, Arch, Nix, LaTeX, TeX, emacs, zsh, ...

Cada entrada tiene 10 columnas: word | ipa | respelling_us | alt_ipa | alt_respelling_us | source_url | source_label | category | confidence | notes. respelling_us es una entrada en inglés simple que se pasa al backend TTS del sistema operativo detectado, de modo que se pronuncie la lectura prevista en lugar de pedirle al motor que adivine a partir del nombre del proyecto.

Anulación local: coloca un ~/.config/say-it/pronunciations.local.tsv y tendrá prioridad.

Lo que funciona hoy

  • ✅ macOS — say integrado.
  • ✅ Linux — espeak-ng (preferido) o espeak.
  • ✅ Windows — PowerShell System.Speech desde la misma CLI de Bash bajo Git Bash/MSYS2/Cygwin.
  • ✅ 1,903 entradas; 1,283 tienen una fuente citable — el resto están etiquetadas por confianza, sin citas inventadas.
  • ✅ Conciencia de múltiples lecturas audibles — las palabras en disputa encadenan alternativas audibles con "o:".
  • ✅ --alt [N], --all, --solo, --why, --json, --md, --no-dict, list, search, quiz, repl, stream, doctor, export, benchmark, badge, cheatsheet.
  • ✅ Habilidad de Claude Code + servidor MCP para preguntas de pronunciación del lado de IA.
  • ✅ GitHub Action — glosarios de pronunciación con fuentes para pull requests de Markdown.
  • ✅ PWA de navegador — instalable, funcional sin conexión, búsqueda instantánea, búsqueda por micrófono, cuestionario interactivo.
  • ✅ Integraciones de editor — Raycast, Alfred, VS Code, Cursor, Codex, Kiro, Continue.
  • ✅ 🌐 Sitio en vivo — pronounce.renlab.ai (1,903 entradas navegables con audio; 1,283 entradas con fuente) + /zh (página de inicio en chino).

Lo que viene

Consulta DESIGN.md para la arquitectura.

  • ☁️ TTS en la nube (ElevenLabs / OpenAI opcionales) para los nombres que el TTS nativo aún distorsiona.
  • 📚 Exportación a Anki para ejercicios de vocabulario.
  • 🌗 Tema claro en la página de inicio v2 (ya disponible en las páginas de palabras/SEO).

Contribuciones

Dos cosas que más queremos:

  1. Entradas de pronunciación. Abre un PR añadiendo una fila a data/pronunciations.tsv. Columnas requeridas: word, ipa, respelling_us. Muy preferido: source_url (entrevista del creador, charla de conferencia, FAQ oficial — cualquier cosa verificable). Las lecturas en disputa son bienvenidas; pon la rival en las columnas alt_* y conectaremos --alt.
  2. Calidad del backend. macOS (say) es el estándar de oro; los backends de Linux (espeak-ng) y Windows (PowerShell) se envían pero son de mejor esfuerzo — ayúdanos a cerrar la brecha. Consulta DESIGN.md §Backends.

Mantenlo pequeño. Mantenlo sin dependencias cuando sea posible. Mantén los valores predeterminados con opiniones (3 repeticiones, GenAm, voz Samantha).

⭐ Apoyo — comienza con una estrella

El diccionario es gratuito y MIT. La única cosa de mayor apalancamiento que puedes hacer es darle una estrella al repositorio — es la señal que atrae a más contribuyentes, más PRs, más entradas aclaradas por los creadores.

Opcional, si te ha ahorrado un dolor real en el standup:

Los dólares cubren el alojamiento (Vercel/Cloudflare/Open VSX), renovaciones de dominio, créditos de narración MiniMax para videos promocionales y tiempo para rastrear citas de creadores para nuevas entradas.

Contribuyentes

Contributors

Cada entrada, mejora de fuente y corrección de habilidad cuenta. Abre un PR — tu cara aparecerá aquí.

Licencia

MIT — consulta LICENSE.

El IPA es una referencia. El audio es un maestro.