IRS libera o Fact Graph como código aberto

• A Receita Federal dos EUA (IRS) liberou como código aberto um grafo de conhecimento chamado Fact Graph
• O Fact Graph é usado para modelar as leis tributárias dos Estados Unidos e legislações relacionadas e pode ser utilizado tanto em ambientes JVM quanto JavaScript
• O código-fonte do projeto é atualizado com frequência, e o desenvolvimento ocorre em um repositório privado, com as mudanças aprovadas sendo refletidas em tempo real
• O Fact Graph é desenvolvido e disponibilizado de acordo com diversas bases legais e políticas federais de código aberto
• Os usuários assumem toda a responsabilidade pelo uso e modificação do software, e o IRS não oferece garantias nem suporte específicos

---

Importância e vantagens da abertura como código aberto

• O fato de o IRS ter tornado o projeto Fact Graph open source é um movimento significativo dentro da tendência de ampliar a transparência e a reutilização de dados governamentais e informações jurídicas
• Diferentemente de outros projetos genéricos de grafo de conhecimento, ele foi projetado como uma estrutura de alta qualidade pronta para ambientes de produção, especializada na legislação tributária dos EUA e em regulações federais, o que aumenta sua utilidade e confiabilidade nessa área
• Ele oferece suporte tanto a JavaScript quanto ao ecossistema JVM (por exemplo, Java, Kotlin, Scala, Clojure etc.), garantindo ampla compatibilidade com diferentes stacks tecnológicos
• Mantém-se atualizado por meio de atualizações frequentes no repositório e de um sistema de integração em tempo real
• Ao seguir de forma clara as bases legais e as políticas de código aberto, fornece uma base confiável para uso por órgãos públicos, empresas e indivíduos

Visão geral do projeto

• O Fact Graph é um grafo de conhecimento pronto para uso em produção, com o objetivo principal de modelar o código tributário federal dos EUA (Internal Revenue Code) e legislações tributárias relacionadas
• Pode ser utilizado não apenas com JavaScript, mas também em todas as linguagens baseadas na JVM (Java, Kotlin, Scala, Clojure etc.), sendo aplicável a diversas plataformas e ambientes de desenvolvimento

Uso do repositório e participação no desenvolvimento

• O ambiente de desenvolvimento e o método de configuração podem ser consultados em ONBOARDING.md
• As melhorias da versão mais recente (v3.1) em relação à versão anterior são fornecidas em documentação e links separados
• As formas de contribuição open source e o guia correspondente estão detalhados em CONTRIBUTING.md

Principais características

• O código-fonte do projeto é atualizado regularmente, e o desenvolvimento real é feito em um repositório privado; depois da revisão, apenas as mudanças aprovadas são mescladas em tempo real no repositório principal (branch main)
• A documentação menciona ScalaTest (framework de testes) e scala-xml (implementação de XML), explicando claramente as principais dependências e ferramentas

Direitos legais e avisos

• A base legal deste projeto foi estabelecida por várias leis e políticas federais dos EUA (por exemplo, Source Code Harmonization And Reuse in Information Technology Act, Federal Source Code Policy, Digital Government Strategy etc.)
• O IRS não garante nem se responsabiliza pela precisão, integridade ou funcionalidade desse código
• Toda a responsabilidade relacionada ao uso do software é do próprio usuário (incluindo resultados tributários, erros de cálculo, perda de dados etc.)
• É necessário cumprir a licença de código aberto e as licenças de terceiros

Informações de linguagem e tecnologia

• 99,9% de todo o código-fonte é escrito em Scala
• Além disso, há alguns trechos escritos em Makefile e similares

Outras informações

• Este projeto ainda não teve uma release oficial publicada e conta com 235 estrelas (stars) e 11 forks
• Ao todo, 11 contribuidores participam do projeto

[GN⁺]

Comentários no Hacker News

• Estou me perguntando se sou eu que estou entendendo algo errado, ou se este repositório realmente não inclui nenhum <i>fato</i> relacionado à legislação tributária; queria saber se o arquivo /demo/all-facts deve ser considerado um conjunto de fatos “reais” e se os arquivos XML de fatos podem ser obtidos em outro lugar. A forma como o IRS define e mantém as fórmulas de cálculo de impostos é bem legal, e a ideia de uma legislação tributária legível por máquina também é realmente interessante.
  • A implementação real da legislação tributária do IRS existe em um repositório separado: https://github.com/IRS-Public/direct-file. O repositório originalmente vinculado cuida da ferramenta de fact graph separada da implementação tributária.
  • Na documentação aqui: "Padronizar dicionários de fatos para criar um formato canônico para modelar logicamente regras tributárias de forma declarativa"
  • Parece mais uma interface HTTP para um banco de dados do que dados reais.
  • Pelo que eu sei, fact significa uma suposição ou fato compartilhado. Na legislação tributária, essa abordagem é totalmente razoável.
• Tive uma experiência extremamente frustrante com o TurboTax por causa da interface excessivamente complicada, da coleta agressiva de dados que finge economizar seu dinheiro quando na prática não faz isso, e de uma estrutura de preços tão complexa quanto a do próprio IRS. Espero que este projeto permita que especialistas do domínio ou pessoas bem-intencionadas criem com facilidade uma alternativa transparente e amigável ao usuário que desafie o domínio de mercado do TurboTax. Queria saber se alguém já encontrou uma boa ferramenta ou abordagem que melhore esses problemas.
  • Usei o DirectFile por apenas um ano e ele foi realmente bom, resolvendo os problemas mencionados acima. Depois disso também houve medidas relacionadas, então não há com o que se preocupar. Artigo relacionado
  • FreeTaxUSA é realmente excelente.
  • Acho que a publicidade do TurboTax chega perto de ser fraude. Freetaxusa.com (sem relação) é igualmente bom e realmente gratuito.
  • No ano passado usei o Free Fill Fillable Forms tanto para o federal quanto para o estadual. Fiquei me perguntando por que não tinha usado antes; eu tinha medo de preencher a declaração por conta própria, mas no meu caso foi realmente simples.
• Fico feliz em ver uma implementação open source da legislação tributária dos EUA. Este código fazia parte da base de código do IRS Direct File e permitia que as pessoas declarassem impostos gratuitamente direto com o IRS. No começo deste ano, o governo Trump encerrou isso. O Fact Graph já havia sido aberto como open source alguns meses antes, e essa versão está aqui, mas fico curioso sobre o motivo da criação de um segundo repositório.
  • Também tenho curiosidade. Imagino que talvez o objetivo seja separá-lo do projeto direct file para que possa ser usado de forma independente para fins mais gerais.
  • Ainda sinto falta do Direct File; foi um começo com muito potencial.
• Fico curioso se isso poderia ser combinado com LLMs para oferecer conselhos interessantes sobre legislação tributária. Seria muito bom poder fazer perguntas de forma fácil e regular sobre regras tributárias.
  • patio11 disse que isso já lhe economizou mais de $2.000. Talvez algum dia ele escreva um relato mais formal. (Threads relacionadas: primeira, segunda)
  • Fico curioso se alguém já criou um modelo treinado em legislação tributária. Certamente seria interessante.
  • Para uso apenas por diversão, tudo bem, mas seguir conselhos fiscais/jurídicos errados que um LLM inventou em uma alucinação é um grande NÃO.

• Este projeto é de domínio público nos EUA por ser um trabalho do governo dos Estados Unidos.<br>Fico curioso sobre o significado da formulação de licença “domínio público nos EUA”. Queria saber se isso significa que esse software não pode ser usado fora dos Estados Unidos.

  • Se você quer entender o significado de “domínio público nos EUA”, precisa ler a frase inteira (até as duas frases imediatamente antes do texto da CC 1.0 Universal). <br>> Não pode ser usado fora dos EUA? <br>A licença explica duas coisas:<br> (1) sem necessidade de licença separada, por ser um trabalho do governo federal dos EUA, ele automaticamente está em domínio público dentro dos EUA; <br>(2) fora dos EUA, quando o detentor dos direitos autorais é o governo federal dos EUA (especialmente em países que aplicam os princípios da Convenção de Berna), a renúncia global de direitos autorais é feita por meio da declaração CC 1.0 Universal. <br>Então, na prática, ele pode ser usado livremente em qualquer lugar do mundo sem restrições de copyright.

  • Alguns países não reconhecem o conceito de domínio público. Nos EUA, muitos trabalhos do governo estão em domínio público. Por causa dessas diferenças jurídicas internacionais, o governo dos EUA tenta atingir esse objetivo declarando domínio público e, ao mesmo tempo, concedendo internacionalmente uma licença com intenção semelhante ao domínio público.
  • Boa pergunta. Como as leis de direitos autorais variam de país para país, talvez isso seja uma tentativa de deixar claro que fora dos EUA não se aplica nenhuma licença especial.
• Para mim o código parecia Scala, mas meu cérebro confundiu com Clojure, então nos primeiros segundos fiquei confuso tentando entender a ausência de parênteses.
• Isso foi uma parte realmente divertida e legal da divulgação do código do Direct File. Discussão antiga no HN. Em especial, aquela versão ainda deixou um tutorial inline bem decente como referência: link do tutorial
• Fico curioso se as regras (regras tributárias) têm controle de versão. Dei uma olhada e não consegui encontrar.
• Fico curioso sobre como eu poderia hackear isso para economizar dinheiro.
• Ainda me surpreende o fato de o IRS ainda existir.