Repolode
Enviar
tconbeer

tconbeer/harlequin

Uma IDE SQL de terminal com cliente DuckDB integrado e adaptadores plug-in para vários bancos de dados, além da CLI complementar hsql, sem interface interativa, para agentes e scripts.

Alternativa open source a:DBeaverDataGrip

Ver no GitHubSite
Estrelas
6,514
Forks
188
Issues abertas
36
Último commit
há 1 hora

O que é?

Harlequin é um cliente SQL que roda no terminal em uma interface de tela cheia. Ele vem com um adaptador DuckDB que inclui o mecanismo DuckDB em processo, além de um adaptador SQLite3. Outros bancos de dados, como Postgres, MySQL/MariaDB, Snowflake e fontes ODBC, estão disponíveis em pacotes de adaptadores instaláveis. É possível abrir bancos de dados em memória ou armazenados em arquivos diretamente pela linha de comando e configurar conexões e opções usando arquivos de perfil.

Além do aplicativo interativo, Harlequin inclui o hsql, uma CLI complementar que usa os mesmos adaptadores e arquivos de configuração, mas foi projetada para uso não interativo. O hsql pode executar consultas e exibir resultados, navegar pelo catálogo para consultar esquemas, relações e colunas e pesquisar em diferentes níveis do catálogo. O modo somente leitura e os limites de tempo para consultas ajudam a restringir o que ferramentas automatizadas podem fazer. Os perfis de configuração podem ler credenciais de variáveis de ambiente e ocultar valores secretos ao exibi-los.

Harlequin é um pacote Python que pode ser instalado com uv, pip ou Homebrew e roda em Linux, macOS e Windows.

Recursos principais

  • 01Editor SQL em tela cheia e visualização de resultados no terminal.
  • 02Adaptadores DuckDB e SQLite3 integrados, com outros bancos de dados disponíveis como plug-ins.
  • 03Navegação pelo catálogo de dados para consultar esquemas, tabelas e colunas.
  • 04Perfis de configuração com substituição por variáveis de ambiente e segredos ocultos.
  • 05CLI complementar hsql para scripts e agentes, com modo somente leitura e limites de tempo para consultas.

Casos de uso

  • Consultar arquivos locais de DuckDB ou SQLite sem sair do terminal.
  • Explorar um data warehouse de produção ou de analytics por SSH, em um shell remoto.
  • Permitir que um agente de IA execute SQL somente leitura em um banco de dados usando o hsql.
  • Executar consultas SQL em scripts de shell ou pipelines de automação.

Em coleções

Aplicativos com interface de terminal (TUI)Ferramentas de CLI e terminalBancos de dados e ferramentas SQL

Tópicos

#sql#terminal#tui#duckdb#database-client#cli#postgres#sqlite#agent#client

Perguntas frequentes

O que é harlequin?
Uma IDE SQL de terminal com cliente DuckDB integrado e adaptadores plug-in para vários bancos de dados, além da CLI complementar hsql, sem interface interativa, para agentes e scripts. Harlequin é um cliente SQL que roda no terminal em uma interface de tela cheia. Ele vem com um adaptador DuckDB que inclui o mecanismo DuckDB em processo, além de um adaptador SQLite3. Outros bancos de dados, como Postgres, MySQL/MariaDB, Snowflake e fontes ODBC, estão disponíveis em pacotes de adaptadores instaláveis. É possível abrir bancos de dados em memória ou armazenados em arquivos diretamente pela linha de comando e configurar conexões e opções usando arquivos de perfil.
harlequin é gratuito? Qual é a licença?
harlequin é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
harlequin ainda é mantido?
Manutenção ativa. O último commit de harlequin foi em 7 de nov. de 2026.
Para que posso usar harlequin?
Consultar arquivos locais de DuckDB ou SQLite sem sair do terminal. Explorar um data warehouse de produção ou de analytics por SSH, em um shell remoto. Permitir que um agente de IA execute SQL somente leitura em um banco de dados usando o hsql. Executar consultas SQL em scripts de shell ou pipelines de automação.
Onde consigo harlequin?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tconbeer/harlequin

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados