stamatios
← Voltar ao feed
Janela de terminal como carteira escolar com robô de lápis, Tau da Hugging Face ensina arquitetura de agentes de código
Open Source

Hugging Face lança Tau, agente de código didático no terminal

resumo de ~3 min
{
  "resumo": "## O que é o Tau\n\nO Hugging Face lançou o Tau, um agente de código que roda no terminal, descrito como um port em Python do agente minimalista Pi. O projeto está disponível publicamente no GitHub sob licença MIT, com cerca de 2,7 mil estrelas e 342 forks, e é publicado no PyPI como `tau-ai`, instalando o comando `tau`. Requer Python 3.12 ou mais recente.\n\nO Tau aceita pedidos como \"explique este repositório\", \"adicione testes\" ou \"corrija este stack trace\", podendo ler arquivos, editar código, executar comandos e manter histórico de sessão durável enquanto transmite o que está fazendo.\n\n## Um projeto para ser lido\n\nAlém de funcionar como ferramenta, o Tau é apresentado como um projeto didático: a intenção é que desenvolvedores entendam a forma de um sistema de agente de código sem precisar estudar uma base de código de produção gigante. A documentação inclui visão de arquitetura, o loop do agente e eventos, e o repositório preserva em `dev-notes/` um diário de construção fase a fase.\n\n## Arquitetura em camadas\n\nO projeto é dividido em três pacotes: `tau_ai`, que traduz provedores de modelos para o fluxo neutro do Tau; `tau_agent`, que contém o \"cérebro\" portátil - mensagens, ferramentas, eventos, loop, harness e primitivas de sessão; e `tau_coding`, que envolve esse núcleo como aplicação de código de verdade: CLI, TUI, ferramentas de arquivo e shell, configuração de provedores, instruções de projeto, skills e sessões em disco.\n\nA fronteira central do design é: `AgentHarness` é o cérebro reutilizável, `CodingSession` é o ambiente de agente de código e a TUI é apenas um possível frontend. O núcleo não conhece Textual, Rich, caminhos de configuração local, comandos de barra ou renderização - os frontends consomem eventos.\n\n## Instalação e uso\n\nO Tau pode ser instalado via scripts oficiais para macOS/Linux e Windows PowerShell (que não usam sudo e permitem inspeção antes da execução), ou diretamente com `uv tool install`, `pipx` ou `pip`. Também está disponível no conda-forge via pixi, e há atualização com `tau update`.\n\nO agente precisa de um provedor de modelo, conectado com `/login`. Há suporte embutido a OpenAI, Anthropic, autenticação por assinatura do OpenAI Codex, OpenRouter, Hugging Face e endpoints compatíveis com OpenAI, incluindo modelos locais. Provedores e modelos próprios podem ser adicionados por um arquivo `~/.tau/catalog.toml`, sem mudar código.\n\nEntre os recursos: TUI interativa em Textual e modo de impressão não interativo (`tau -p \"...\"`), ferramentas internas de leitura, escrita, edição e bash, sessões JSONL duráveis em `~/.tau/sessions/` com retomada e ramificação, comandos de barra para login, seleção de modelo, sessões, compactação e exportação, instruções de projeto via `AGENTS.md` e recursos `.tau/`/`.agents/`, skills de usuário, templates de prompt e temas de TUI, além de contabilidade de contexto com compactação manual ou automática opcional.\n\n## Filosofia\n\nO projeto segue algumas regras explícitas: camadas pequenas vencem mágica; eventos são o contrato entre provedores, renderizadores e frontends; o núcleo permanece portável; ferramentas são funções tipadas comuns (esquema mais executor assíncrono com resultado estruturado); sessões são duráveis e inspecionáveis, com histórico append-only em JSONL em que o contexto ativo pode ser compactado sem reescrever o registro; e a documentação acompanha a implementação.\n\nO harness também pode ser usado como biblioteca: o código de exemplo mostra a criação de um `AgentHarness` com provedor, modelo, system prompt e ferramentas, consumindo eventos em um loop assíncrono.\n\n## Estado do projeto\n\nO Tau está sob desenvolvimento ativo, com o roadmap rastreado na issue nº 1 do GitHub, testes com pytest, checagens com ruff e mypy, e documentação publicada em twotimespi.dev construída com Hugo. A licença é MIT.",
  "hook": "O Hugging Face publicou o Tau, um agente de código que roda no terminal e funciona como port em Python do agente minimalista Pi. Além de executar tarefas como ler arquivos, editar código e rodar comandos, o projeto se propõe como material didático para entender como sistemas de agentes de código são construídos.",
  "entities": [\"Hugging Face\", \"Tau\", \"Pi\"],
  "themes": [\"engenharia-com-ia\"],
  "story_key": \"hugging-face-tau-coding-agent\",
  "reasoning": {
    "story_key": "Lançamento do Tau, agente de código didático em terminal pelo Hugging Face; a chave é o fato canônico.",
    "themes": {
      "engenharia-com-ia": "O assunto é um coding agent (o agente e seu fluxo/arquitetura), não só uma ferramenta acessória; encaixa no critério do tema."
    },
    "entities": {
      "Hugging Face": "Organização que lança e mantém o projeto.",
      "Tau": "O produto lançado, sujeito central do fato.",
      "Pi": "Agente original do qual o Tau é port em Python, mencionado explicitamente como origem do projeto."
    },
    "excluded": {
      "OpenAI/Anthropic/OpenRouter": "Apenas provedores suportados, menções secundárias.",
      "Textual/Rich/uv/Hugo": "Ferramentas de implementação, não sujeitos do fato."
    }
  }
}