Projeto usa IA e código determinístico para declarar imposto na Índia
O itr-wala combina agentes de IA com um motor tributário em Python para preparar declarações indianas no terminal, mantendo os cálculos fora do modelo de linguagem.
Edição: Anderson Gomes
· 4 min de leitura

Criado por karanb192, o repositório itr-wala ganhou destaque no ranking semanal do Trendshift, onde aparece na 13ª posição, após somar 535 estrelas no período analisado. A proposta é permitir o preenchimento da declaração de imposto de renda da Índia, chamada ITR, com apoio de Claude Code, Codex ou Gemini, sem deixar que a IA faça as contas tributárias.
Dados rápidos
- Repositório:
karanb192/itr-wala - Licença: não declarada
- Linguagem: Python
- Popularidade: 579 estrelas e 64 forks
- Ranking: Trendshift semanal, posição #13
- Consulta: 11 de agosto de 2026
O problema que o projeto tenta resolver
O itr-wala foi criado para o ano fiscal AY 2026-27 e atende declarações indianas dos formulários ITR-1, ITR-2, ITR-3 e ITR-4, segundo os prazos descritos no README. O sistema parte de uma divisão entre interpretação de documentos e cálculo tributário.
A IA lê documentos como Form 16, AIS e relatórios de operações de corretoras, conduz uma entrevista sobre possíveis deduções e orienta o usuário durante o preenchimento do portal. Já o cálculo de faixas, abatimentos, sobretaxas, cess, juros e multas é executado por código Python determinístico, isto é, com regras fixas e resultados reproduzíveis.
O projeto também compara os regimes antigo e novo de tributação. A saída inclui a renda total, o imposto calculado e o valor líquido a pagar ou receber, com uma recomendação baseada na opção legalmente mais barata.
Como funciona e como instalar
O fluxo começa com um checkout do código. O script install.sh copia os arquivos locais e, conforme o README, não acessa a internet durante a instalação. Também é possível limitar a instalação à pasta que contém os documentos fiscais.
git clone https://github.com/karanb192/itr-wala.git
cd itr-wala && ./install.sh
Há opções para instalar integrações com Codex, Gemini ou todas elas. Para o Claude Code, o README orienta adicionar o marketplace do repositório e instalar o plugin itr-wala.
Depois da instalação, o usuário abre o agente e escreve “file my ITR”. Os documentos são colocados em uma pasta, os dados são transcritos para income.json e passam por um validador estrito. Campos desconhecidos ou divergências entre os valores de TDS e os totais do 26AS/AIS são sinalizados.
O pacote inclui 47 testes de referência para o motor tributário e 104 testes do validador. Há também um fuzzer, ferramenta que gera entradas aleatórias para encontrar falhas, com casos reproduzíveis em integração contínua.
Casos de uso práticos
- Preparar uma declaração a partir do Form 16 e do AIS, com conferência dos totais informados.
- Comparar os regimes antigo e novo antes de escolher uma opção.
- Identificar deduções relacionadas a 80C, 80D, NPS, HRA e financiamento imobiliário.
- Organizar os valores exigidos pelo portal em uma sequência de preenchimento.
- Conferir juros previstos nas seções 234A, 234B e 234C, além da multa 234F.
O projeto não executa as etapas finais em nome do contribuinte. O README afirma que o usuário deve realizar pessoalmente o pagamento, o envio da declaração e a verificação eletrônica, sem compartilhar senha ou código OTP com o agente.
O que diferencia o itr-wala
A característica central é a separação explícita entre o agente e o motor de cálculo. A IA interpreta documentos, explica resultados e conduz o fluxo; o Python aplica as regras tributárias. O repositório também afirma testar situações específicas, como alívio marginal da seção 87A, ganhos de capital, compensação de perdas, sobretaxas e arredondamentos previstos nas seções 288A e 288B.
O README informa que o fuzzer executa 3.000 casos em cada commit e que mais de 350 mil casos foram analisados antes do lançamento. Um exemplo incluído no projeto apresenta uma economia de ₹42.811 na comparação entre regimes, mas trata-se de uma demonstração baseada em dados fictícios.
Limitações e cuidados antes de usar
O repositório foi criado em 26 de julho de 2026 e recebeu seu último commit em 11 de agosto de 2026. Não há release publicada encontrada, e a licença aparece como não declarada, portanto as condições formais de uso e redistribuição não estão informadas no repositório.
A execução dos scripts Python ocorre na máquina do usuário, segundo o README. Ainda assim, o uso de agentes para leitura de documentos fiscais exige cuidado com a configuração e com os arquivos compartilhados; detalhes adicionais sobre dependências, hospedagem externa e políticas completas de retenção de dados não estão informados no repositório.
Também não há, nos dados disponíveis, confirmação independente da correção fiscal do motor ou explicação sobre suporte a situações que não aparecem nos exemplos. O projeto não substitui a conferência dos documentos nem as obrigações que permanecem sob responsabilidade do contribuinte.
Resumo rápido
- Projeto: preparação de ITR indiana com agentes de IA e cálculo em Python.
- Licença: não declarada.
- Linguagem: Python.
- Estrelas: 579; forks: 64.
- Ranking: Trendshift semanal, #13.
- Risco principal: uso de software recente, sem release publicada e com licença não declarada.
Fontes
- Python
- Repositórios em Alta
- Trendshift
67 mil estrelas: TheAlgorithms/Java é a maior coleção aberta de algoritmos em Java para
Coleção open source de estruturas de dados e algoritmos em Java atrai quase 70 mil desenvolvedores e mantém ritmo constante de contribuições.
· 5 min de leitura
Claude-BugHunter lidera ranking de IA para caça de bugs com 7,7 mil estrelas
Pacote de 83 habilidades para Claude Code automatiza detecção de vulnerabilidades com base em relatórios reais de hackers.
· 5 min de leitura
AG-UI 1.0: padrão aberto padroniza agentes de IA em front-end
Protocolo leve e baseado em eventos permite conectar agentes de IA a web, mobile, Slack e terminais com uma única integração.
· 4 min de leitura
Arcane v3: ferramenta Go de gestão Docker ganha tração em 2026
Ferramenta de código aberto escrita em Go simplifica administração de containers com interface moderna e auto-hospedável.
· 4 min de leitura