Timmy-TUI
woodman33 · Programação
O Timmy-TUI (com a marca TIMMY) é uma interface de terminal de código aberto e um plano de controle para o trabalho de agentes de IA. Ele registra cada execução como um recibo assinado e encadeado por hash, para você ver o que um agente fez, quanto custou e o que produziu. A reprodução funciona só com o recibo. Roda localmente sobre Node.js e conversa com os modelos de fronteira do OpenRouter ou com os modelos gratuitos do Ollama, no modo local, quando você não quer pagar por tokens.
Sobre Timmy-TUI
O que é o Timmy-TUI
O Timmy-TUI é uma caixa-preta local para agentes de IA, empacotada como uma interface de usuário de terminal que você roda na sua própria máquina. O trabalho dele é a responsabilização. Os agentes editam arquivos, executam comandos e chamam modelos. Normalmente você acredita no que eles dizem que aconteceu. O TIMMY, em vez disso, sela um recibo para cada execução: o que rodou, onde, quanto demorou, quanto custou e quais artefatos produziu.
Os recibos são encadeados por hash sha256 e assinados com ed25519, o que significa que cada registro se liga ao anterior. Mude uma entrada e a cadeia quebra. É exatamente essa a ideia. "Confie no recibo, não no modelo" é a própria frase do projeto, e ela resume o design. Se você já viu um agente alegar sucesso enquanto se afastava em silêncio do próprio ambiente, isso foi feito para você.
O limite principal é o público. O Timmy-TUI é uma ferramenta para desenvolvedores que vive num terminal sobre Node.js. Não há painel no navegador para usuários não técnicos, nem app para celular. Alguns caminhos que ele inclui, como os fluxos 3D para Blender ou Unreal, partem do princípio de que você já tem essas ferramentas instaladas.
Primeiros passos
- Clone o repositório com
git clone https://github.com/woodman33/timmy-tui.gite depois rodenpm installdentro da pasta.
- Copie
.env.examplepara.enve adicione umaOPENROUTER_API_KEYse quiser modelos de fronteira. Pule essa etapa e o TIMMY recorre aos modelos locais do Ollama sem custo.
- Inicie a TUI com
npm start. AperteTabpara trocar de aba,?para a gramática de teclas eCtrl+Kpara a paleta de comandos.
- Rode
timmy demopara selar seu primeiro recibo em.timmy/receipts/demo-receipt.json, outimmy proof "create a hello world worker"para gerar uma pasta completa de execução de prova com um arquivo de reprodução.
- Aponte qualquer agente que fale MCP para o servidor embutido com
timmy mcp servee comece a gravar as chamadas de ferramenta dele.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de Timmy-TUI.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores que rodam agentes em scripts de produção
- Equipes que precisam auditar o gasto com modelos
- Quem tem receio das faturas de modelos de fronteira para tarefas leves
- Engenheiros que já vivem num terminal
Tarefas
- Reproduzir uma execução falha de um agente
- Verificar se uma execução realmente deu certo
- Distribuir um prompt entre vários modelos
- Registrar chamadas de ferramenta dentro de um agente que já existe
Cenários
- Depurar um agente que gerou um arquivo quebrado às 2 da manhã
- Passar o trabalho para um colega
- Acompanhar custos ao longo de uma semana de experimentos com agentes
- Flagrar um modelo que mudou em silêncio
Principais recursos
Recibos assinados e encadeados por hash
Cada execução é selada num recibo com encadeamento por hash sha256 e uma assinatura ed25519. Ele guarda os hashes do prompt e da resposta, o uso de tokens, o custo, a latência e uma classe de erro. Execuções falhas e execuções negadas também são seladas, então as lacunas de um registro não são silenciosas. Esse último detalhe importa. Quase toda ferramenta de log registra só os sucessos, que é justo quando você menos precisa do histórico.
Trava de ambiente e reprodução honesta
O TIMMY vincula o sistema operacional, a arquitetura e os hashes de build das ferramentas a cada recibo. Quando você reproduz, ele se recusa a fingir que uma máquina desviada é a mesma que produziu a execução. Então uma reprodução ou bate com o ambiente ou avisa que não bate. A reprodução lê só do manifesto, enquanto as listas de corte EDL remontam os clipes num pacote portátil .agentrun que carrega as edições, os hashes e os recibos com intercâmbio OTIO para ferramentas que falam esse formato.
Posto de comando e delegação
O Posto de comando recebe um DispatchPlan tipado, validado com CUE, e o executa por um ciclo de vida. Os tokens de operador se vinculam ao hash completo do plano, então a aprovação é de uso único e expira. As rotas pagas negam por padrão sem um limite de gasto, o que impede um agente de subir uma fatura sem avisar. É um guard-rail que você configura uma vez e esquece.
Caminhos de execução
O TIMMY conduz agentes por vários caminhos de execução, cada um feito para um tipo de trabalho. Entre eles estão o OpenHands em modo sandbox descartável ou nada, o OpenCode, o Pi e o jcode. Há caminhos 3D para Blender, Godot, Unity, Unreal e Houdini, além de caminhos de API protegidos por chave. A multiplexação de terminal com tmux, zellij e rmux deixa você ver várias execuções ao mesmo tempo.
Laços de juiz
Para respostas com mais confiança, os laços de juiz distribuem um prompt entre vários modelos em local e só escalam para um modelo de fronteira quando a confiança cruza um limite. Cada laço sela tanto os recibos filhos quanto o pai, então você rastreia como se chegou a uma resposta final em vez de ver só o ponto de chegada.
Servidor MCP e serviços complementares
O servidor MCP embutido expõe 24 ferramentas a qualquer agente que fale MCP, com uma ponte de execução de cliente e um caminho de invocação OpenAPI que deixa um agente existente entregar trabalho sem reconstruir a própria camada de ferramentas. Os serviços complementares somam um espelho de chat no navegador na porta 3001, um navegador de recibos e uma pesquisa de despacho na 4310, e um Mission Map na 4321. Assim o trabalho no terminal tem uma camada visual quando você quiser.
Prós e contras
Prós
- Os recibos são assinados e encadeados por hash, então adulterar o log é detectável em vez de passar em silêncio.
- Roda inteiramente em local sobre Node.js, o que mantém os dados do agente na sua própria máquina.
- Os modelos locais gratuitos do Ollama fazem você trabalhar a $0 quando o acesso de fronteira está indisponível ou não é desejado.
- A trava de ambiente torna a reprodução honesta sobre o desvio em vez de dar resultados enganosos.
- O servidor MCP envolve agentes existentes sem forçar uma reescrita.
- Código aberto sob licença MIT, então você lê e muda o código.
Contras
- É uma interface de terminal, então quem está fora de um fluxo de desenvolvimento vai achar a interface difícil.
- A lista de recursos é densa. Recibos, planos de despacho e laços de juiz levam tempo de aprendizado antes de o retorno aparecer.
- Alguns caminhos 3D e de API precisam da ferramenta externa ou da chave já configurada, então não são plug-and-play.
- Os recibos cobrem só o que passa pelo TIMMY. Um agente que nunca o toca não deixa registro.
Perguntas frequentes
O Timmy-TUI é uma caixa-preta para agentes de IA. Ele registra as execuções como recibos assinados e encadeados por hash, capturando o que rodou, em qual ambiente, quanto demorou e quanto custou. A reprodução do agente funciona depois só com o recibo. A melhor descrição é caixa-preta e plano de controle para a atividade de agentes.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a Timmy-TUI.
Alternativas a Timmy-TUI
Forefront
Forefront · ProgramaçãoO Forefront é uma plataforma web para construir com IA de código aberto. Você ajusta os principais modelos de linguagem de código aberto com seus próprios dados, avalia o desempenho deles e os roda por uma API ou os exporta para hospedar por conta própria. Desenvolvedores que querem a conveniência de uma plataforma fechada, mas fazem questão de ser donos dos modelos e dos dados, são o público-alvo aqui.
Startkit
StartKit.AI · ProgramaçãoStartkit é um boilerplate para criar produtos de SaaS com IA e wrappers de IA. Pense nele como um boilerplate para startups de IA com as partes chatas já conectadas: autenticação, pagamentos com Stripe e Lemon Squeezy, limites de uso, e-mail transacional e um kit inicial de API de IA que conversa com OpenAI, Anthropic, Groq ou Llama. Você clona o repositório, define seu preço e começa pela parte do produto que as pessoas realmente pagam. Ele é feito em Next.js sobre React e Tailwind, então boa parte do código boilerplate já parece familiar.
Testim
Tricentis · ProgramaçãoO Testim é uma plataforma de automação de testes com IA para criar e executar testes de ponta a ponta em aplicações web, mobile e Salesforce. Ele se apoia no aprendizado de máquina para manter os testes estáveis quando uma interface muda, então as equipes gastam menos tempo consertando seletores quebrados. Nada mal para uma ferramenta de testes automatizados que você pode começar a usar hoje. Você cria testes gravando ações no navegador e depois adiciona JavaScript quando precisa de mais controle. É uma escolha sólida para equipes de QA ocupadas.