
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."
}
}
}