Pronounce

Dicionário de pronúncia para jargão de desenvolvedores - IPA, ressoação e áudio para mais de 1.650 entradas com fontes (kubectl, nginx, JSON).

GitHub
39
Experimente este MCPPatrocinado

Documentação

🔊 say-it · Pronounce

Pare de dizer "kub-cuttle". Um comando Bash pronuncia 1.903 nomes de jargão de desenvolvedor — a maioria com fonte citada.

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

🌐 pronounce.renlab.ai · 🇨🇳 中文 · 📖 Navegar · 🎯 Quiz · 🎤 Busca por voz · 🔌 Servidor MCP · ⚙️ GitHub Action

say-it kubectl — terminal demo

▶ Assista ao promo de 47 segundos (com voz) · 🎯 Experimente o quiz · 🎤 Busca por voz

🚀 Experimente em 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

É isso. Agora tente say-it GIF, say-it nginx, say-it Pydantic, say-it --why JSON ou say-it quiz para um desafio de 10 perguntas. Usuários de Linux: instale espeak-ng (sudo apt install espeak-ng) e a CLI simplesmente funciona. Windows: a mesma CLI via WSL ou git-bash + PowerShell. Ou pule a instalação e use o navegador em pronounce.renlab.ai.

⭐ Se say-it kubectl te poupar de um momento constrangedor no standup — dê uma estrela no repositório. Isso incentiva mais devs a contribuir com seus nomes de projetos mal pronunciados favoritos.

Star history

🏆 O placar de pronúncia para desenvolvedores

1.903 entradas — 1.283 com fonte citável — 108 resolvidas pelo próprio criador, 175 que a comunidade ainda discute. As famosas:

✅ Resolvidas — o criador confirmou

PalavraÉ……não éResolvido por
GIF"jif""ghif" (dica de fala com G forte)Steve Wilhite (criador), NYT 2013
nginx"engine X""n-jinx"NGINX oficial
YAML"yam-ul""yammel"yaml.org
GNU"guh-NEW" (G forte)"noo"Projeto GNU
LaTeX"lay-tek""lay-teks"Lamport / Projeto LaTeX
TOMLrima com "knoll""tom-el"Tom Preston-Werner (criador)
Tcl"tickle""T-C-L"John Ousterhout (criador)
awk"auk" (como o pássaro)"A-W-K"Aho / Weinberger / Kernighan

⚔️ Ainda em disputa — ambas as leituras estão em uso ativo

PalavraGrupo AGrupo B
kubectl"koob-control""cube-cuddle"
SQL"sequel""S-Q-L"
JSON"JAY-son""JEE-son"
GUI"gooey""G-U-I"
JWT"jot" (conforme RFC 7519)"J-W-T"

Cada célula tem IPA e áudio; 1.283 também têm uma fonte citável. Navegue por todas as 1.903 entradas →

Discorda de alguma? É exatamente esse o ponto — abra um PR com sua leitura e uma fonte. A discussão é o conjunto de dados.

O que você está realmente recebendo

  • 1.903 entradas — 1.283 com fonte citável. Marcadas por confiança (creator-clarified / community-consensus / contested), cada uma com uma URL citável quando existe (preferimos deixar em branco a inventar uma). Wilhite disse que GIF é "jif" no Webby Awards de 2013. Crockford diz que JSON é "JAY-son" (RailsConf 2009). A RFC 7519 diz que JWT é "jot". O dicionário os cita.
  • Áudio com múltiplas leituras. Para palavras onde o debate é real — GIF, SQL, GUI, char, regex — a CLI encadeia as alternativas após a principal com um "ou:" falado, para que você ouça o debate sem ficar olhando para o terminal. --solo pula a cauda depois que você internalizou.
  • Uma CLI Bash, sem runtime npm. Sem sudo, sem bootstrap de framework, sem surpresas. Ela detecta macOS say, Linux espeak-ng/espeak ou Windows PowerShell System.Speech. O repositório também inclui uma habilidade para Claude Code e um servidor MCP para que sua IA responda "como se pronuncia X?" com áudio, não com um palpite fonético.
  • Uma GitHub Action nativa para docs. Analise o Markdown alterado por um pull request e emita um glossário de pronúncia com fontes no resumo do job — sem chave de API, instalação de dependências ou requisição de rede.
  • Áudio canônico no site. O site reproduz cada MP3 canônico commitado primeiro e usa Web Speech apenas como fallback se a reprodução falhar.
$ 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 que não simplesmente Google?

Porque o Google te dá 47 discussões no Reddit e um clipe do YouTube que você precisa desmutar. O IPA te dá /ˈkuːb kənˌtroʊl/ — uma referência, não um professor.

Você não precisa de uma transcrição fonética. Você precisa ouvir a palavra. Duas vezes. Talvez três. Pronto.

say-it inclui um dicionário mantido pela comunidade de como engenheiros realmente dizem os nomes que tropeçam todo mundo — e alimenta a reescrita pretendida ao mecanismo de texto-para-fala do seu sistema operacional, para que kubectl saia como koob-control, não como o que seu computador adivinhou a partir das letras.

Momentos famosos

Algumas pronúncias não são opiniões — os criadores as resolveram. O dicionário cita cada uma:

PalavraLeituraFonte
GIF"jif" (o criador diz)Steve Wilhite, Webby Awards 2013
JSON"jay-son"Douglas Crockford, RailsConf 2009
GNU"g-noo" (G forte, uma sílaba)Projeto GNU oficial
Linux"LIN-ux" (i curto, schwa)O próprio Linus Torvalds
LaTeX"lay-tek" (ou "lah-tek")Leslie Lamport, oficial
Django"JANG-go" (D silencioso)FAQ do Django
Vue"view" (uma sílaba)Evan You, docs do Vue
Vite"veet" (francês para rápido)Docs do Vite
Knative"KAY-native" (o K é sonoro)Docs do Knative
etcd"et-cee-dee" (et-cetera-distributed)FAQ do etcd

Execute say-it --why <word> para ver a citação quando uma entrada tem um source_url; entradas sem fonte são deixadas em branco em vez de receber uma URL fabricada.

Instalação

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

Ou o bloco "Experimente em 30 segundos" acima. ./install.sh instala:

  • a CLI em ~/.local/bin/say-it,
  • o dicionário de pronúncia em ~/.local/share/say-it/pronunciations.tsv,
  • se você usa Claude Code, uma habilidade pronounce-word em ~/.claude/skills/pronounce-word/ para que qualquer prompt "como se diz X?" para sua IA seja respondido com áudio em vez de IPA,
  • a mesma habilidade em ~/.agents/skills/ (Codex CLI) e ~/.kiro/skills/ (Kiro) quando esses diretórios existirem — é o padrão Agent Skills entre ferramentas.

Certifique-se de que ~/.local/bin esteja no seu $PATH. Linux também funciona — instale espeak-ng (sudo apt install espeak-ng / brew install espeak-ng). Windows: WSL ou git-bash + PowerShell. Ou pule a instalação completamente com a versão de navegador em 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

A voz padrão do macOS é Samantha (General American); -v <voice> seleciona outra voz do macOS. Linux e Windows usam a voz em inglês do backend detectado. O dicionário é somente GenAm, por design.

Integração com Claude Code

Instale a Agent Skill entre ferramentas diretamente com a 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.

Uma vez instalada, a habilidade pronounce-word é acionada automaticamente em:

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

Sua IA responde com som, não apenas um palpite fonético. Arquivo da habilidade: skills/pronounce-word/SKILL.md.

Não usa Claude? A mesma habilidade funciona no Codex CLI (codex plugin marketplace add anzy-renlab-ai/pronounce) e no Kiro (~/.kiro/skills/), e o servidor MCP cobre Claude Desktop, Cursor, Continue, Zed, Cline e outros — matriz completa em integrations/.

Add to Kiro

GitHub Action — guias de pronúncia para docs

Adicione um glossário de pronúncia a cada pull request de documentação:

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

Pronounce Docs analisa o Markdown/MDX alterado e escreve uma tabela contendo cada termo correspondente, seu IPA, reescrita em inglês simples, página de áudio e fonte do criador ou oficial quando disponível. Ela roda localmente a partir do snapshot do repositório: sem token, chave de API, telemetria, instalação de pacotes ou requisição de rede. Veja a configuração completa, entradas e saídas.

Extensão VS Code

Install from VS Code Marketplace Install from Open VSX

Pronounce demo — kubectl, YAML, Ghostty, wagmi

Passe o mouse sobre qualquer palavra técnica em qualquer arquivo — veja o IPA, ouça a pronúncia. O mesmo dicionário de 1.903 entradas da CLI, empacotado em JSON no build (custo zero de parse em runtime).

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

Agora também no Microsoft Marketplace: ext install sayit.pronounce no VS Code. Veja a listagem no marketplace.

  • Hover sobre kubectl, YAML, Ghostty, wagmi… → tooltip com IPA + 🔊 Play + link ★ Star.
  • ⌘⇧' — fala a seleção.
  • Barra de status 🔊 sayit — clique para falar a seleção atual.
  • Walkthrough de boas-vindas — onboarding em 4 etapas na primeira instalação.
  • Pronounce: Search dictionary… — busca difusa por todas as 1.903 entradas.

Fonte: integrations/vscode/. Multiplataforma a partir da v0.3 — macOS say, Linux espeak-ng, Windows PowerShell.

Extensão Chrome / Edge / Brave

Clique em qualquer palavra técnica em qualquer página da web → popup com IPA + áudio. O mesmo dicionário de 1.903 entradas. A extensão fala via Web Speech; pronounce.renlab.ai reproduz o corpus MP3 commitado primeiro e reserva Web Speech para fallback. Apenas sideload por enquanto (ainda não está na Chrome Web Store).

Baixe pronounce-chrome-0.3.1.zip → descompacte → chrome://extensions/ → Modo desenvolvedor → Load unpacked.

Fonte: integrations/chrome/.

Como o dicionário funciona

data/pronunciations.tsv é a fonte única da verdade — separado por tabulações, 1.903 entradas, cobrindo:

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

Cada entrada tem 10 colunas: word | ipa | respelling_us | alt_ipa | alt_respelling_us | source_url | source_label | category | confidence | notes. respelling_us é uma entrada simples em formato de inglês passada ao backend de TTS do SO detectado, para que a leitura pretendida seja falada em vez de pedir ao mecanismo para adivinhar a partir do nome do projeto.

Substituição local: coloque um ~/.config/say-it/pronunciations.local.tsv e ele terá precedência.

O que funciona hoje

  • ✅ macOS — say integrado.
  • ✅ Linux — espeak-ng (preferido) ou espeak.
  • ✅ Windows — PowerShell System.Speech do mesmo CLI Bash sob Git Bash/MSYS2/Cygwin.
  • ✅ 1.903 entradas; 1.283 com fonte citável — o restante é marcado por confiança, sem citações fabricadas.
  • ✅ Consciência de múltiplas leituras audíveis — palavras contestadas encadeiam alternativas audivelmente com "ou:".
  • ✅ --alt [N], --all, --solo, --why, --json, --md, --no-dict, list, search, quiz, repl, stream, doctor, export, benchmark, badge, cheatsheet.
  • ✅ Habilidade Claude Code + servidor MCP para perguntas de pronúncia do lado da IA.
  • ✅ GitHub Action — glossários de pronúncia com fontes para pull requests em Markdown.
  • ✅ PWA de navegador — instalável, funcional offline, busca instantânea, busca por voz no microfone, quiz interativo.
  • ✅ Integrações de editor — Raycast, Alfred, VS Code, Cursor, Codex, Kiro, Continue.
  • ✅ 🌐 Site ao vivo — pronounce.renlab.ai (1.903 entradas navegáveis com áudio; 1.283 entradas com fonte) + /zh (página inicial em chinês).

O que está por vir

Veja DESIGN.md para a arquitetura.

  • ☁️ TTS em nuvem (opt-in ElevenLabs / OpenAI) para os nomes que o TTS nativo ainda estraga.
  • 📚 Exportação Anki para treinos de vocabulário.
  • 🌗 Tema claro na página inicial v2 (já enviado nas páginas de palavra/SEO).

Contribuindo

Duas coisas que mais queremos:

  1. Entradas de pronúncia. Abra um PR adicionando uma linha ao data/pronunciations.tsv. Colunas obrigatórias: word, ipa, respelling_us. Altamente preferido: source_url (entrevista do criador, palestra de conferência, FAQ oficial — qualquer coisa verificável). Leituras contestadas são bem-vindas; coloque a rival nas colunas alt_* e conectaremos --alt.
  2. Qualidade do backend. macOS (say) é o padrão ouro; os backends Linux (espeak-ng) e Windows (PowerShell) são enviados, mas são de melhor esforço — ajude-nos a fechar a lacuna. Veja DESIGN.md §Backends.

Mantenha pequeno. Mantenha sem dependências quando possível. Mantenha os padrões opinativos (3 repetições, GenAm, voz Samantha).

⭐ Suporte — comece com uma estrela

O dicionário é gratuito e MIT. A coisa de maior alavancagem que você pode fazer é dar uma estrela no repositório — é o sinal que atrai mais contribuidores, mais PRs, mais entradas esclarecidas por criadores.

Opcional, se isso economizou dor real no standup:

Os dólares cobrem hospedagem (Vercel/Cloudflare/Open VSX), renovações de domínio, créditos de narração MiniMax para vídeos promocionais e tempo para rastrear citações de criadores para novas entradas.

Contribuidores

Contributors

Cada entrada, atualização de fonte e correção de habilidade conta. Abra um PR — seu rosto aparece aqui.

Licença

MIT — veja LICENSE.

IPA é uma referência. Áudio é um professor.