Repolode
OleksandrChekhovskyi

OleksandrChekhovskyi/hax

Agente de programação minimalista e nativo de terminal, escrito em C, compatível com modelos locais do llama.cpp e vários provedores de LLM na nuvem.

Alternativa open source a:Claude Code

Estrelas
975
Forks
67
Issues abertas
21
Último commit
há 8 dias

O que é?

hax é um agente de programação que roda no terminal como um único binário nativo em C, com poucas dependências. Ele oferece um REPL interativo, um modo de execução única (`-p`) que imprime apenas a resposta final em stdout e a retomada de sessões para continuar conversas anteriores em um diretório de projeto específico.

Ele se conecta à OpenAI e a endpoints compatíveis, Anthropic, Codex por meio de uma assinatura do ChatGPT, OpenRouter, OpenCode Zen/Go, DeepSeek, llama.cpp, Ollama e endpoints personalizados. Com um llama-server em execução, hax detecta automaticamente o modelo carregado e seus recursos, sem precisar de um bloco de configuração do provedor.

hax transmite Markdown e a saída das ferramentas sem alterar o histórico de rolagem nativo do terminal. A visualização da transcrição (Ctrl+T) mostra exatamente o que foi enviado ao modelo e o que ele respondeu, e também é possível coletar um rastreamento opcional do protocolo wire. Os arquivos de configuração e de sessão são texto simples, e as extensões são executadas por subprocessos externos, em vez de um runtime de plugins.

Recursos principais

  • 01Um único binário nativo em C, com poucas dependências e baixo consumo de memória.
  • 02Detecta automaticamente modelos servidos pelo llama.cpp, sem configuração manual do provedor.
  • 03Transmite Markdown e a saída das ferramentas, preservando o histórico de rolagem do terminal.
  • 04A visualização da transcrição e o rastreamento opcional do protocolo wire mostram exatamente as solicitações enviadas ao modelo e as respostas recebidas.
  • 05Compatível com vários provedores, incluindo OpenAI, Anthropic, OpenRouter, DeepSeek, Ollama e endpoints personalizados.
  • 06Arquivos de configuração e de sessão em texto simples, com caminhos compatíveis com XDG.

Casos de uso

  • Executar um assistente de programação com um modelo local do llama.cpp ou do Ollama.
  • Usar prompts de execução única em scripts no shell, com saída limpa em stdout.
  • Auditar exatamente o que um agente de programação envia a um modelo e recebe dele.
  • Usar um agente em máquinas com recursos limitados ou empacotá-lo para distribuições Linux.

Início rápido

  1. 1

    Instalar pelo Homebrew

    brew install oleksandrchekhovskyi/hax/hax
  2. 2

    Iniciar um servidor local do llama.cpp com seu modelo

    llama-server -m [model].gguf
  3. 3

    Executar hax com o provedor do llama.cpp

    hax --provider llama.cpp

Antes de usar

  • O Windows não é compatível nativamente; é necessário executá-lo no WSL.
  • Em sistemas BSD, só há suporte para compilação a partir do código-fonte.
  • Alguns recursos avançados, como marketplaces de MCP, plugins, painéis de IDE e solicitações de permissão, foram omitidos intencionalmente.

Em coleções

Tópicos

Perguntas frequentes

O que é hax?
Agente de programação minimalista e nativo de terminal, escrito em C, compatível com modelos locais do llama.cpp e vários provedores de LLM na nuvem. hax é um agente de programação que roda no terminal como um único binário nativo em C, com poucas dependências. Ele oferece um REPL interativo, um modo de execução única (`-p`) que imprime apenas a resposta final em stdout e a retomada de sessões para continuar conversas anteriores em um diretório de projeto específico.
hax é gratuito? Qual é a licença?
hax é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
hax ainda é mantido?
Manutenção ativa. O último commit de hax foi em 30 de out. de 2026.
Para que posso usar hax?
Executar um assistente de programação com um modelo local do llama.cpp ou do Ollama. Usar prompts de execução única em scripts no shell, com saída limpa em stdout. Auditar exatamente o que um agente de programação envia a um modelo e recebe dele. Usar um agente em máquinas com recursos limitados ou empacotá-lo para distribuições Linux.
Como instalar hax?
Instalar pelo Homebrew: brew install oleksandrchekhovskyi/hax/hax Iniciar um servidor local do llama.cpp com seu modelo: llama-server -m [model].gguf Executar hax com o provedor do llama.cpp: hax --provider llama.cpp
Onde consigo hax?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/OleksandrChekhovskyi/hax

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

Projetos relacionados