IRSがFact Graphをオープンソースとして公開

 (github.com/IRS-Public)
1 ポイント 投稿者 GN⁺ 2025-10-17 | 1件のコメント | WhatsAppで共有
  • 米国内国歳入庁（IRS）が Fact Graph というナレッジグラフをオープンソースとして公開
  • Fact Graphは 米国税法および関連法令 をモデリングするために使われ、JVMおよびJavaScript環境 の両方で利用可能
  • プロジェクトのソースコードは頻繁に更新され、開発は 非公開リポジトリ で行われた後、承認された変更がリアルタイムで反映される
  • Fact Graphは さまざまな法的根拠と連邦オープンソース政策 に基づいて開発・公開されている
  • 利用者はソフトウェアの使用および変更に伴う すべての責任 を負い、IRSは個別の保証やサポートを提供しない

オープンソース公開の重要性と利点

  • IRSがFact Graphプロジェクトをオープンソース化したことは、政府データおよび法令情報の透明性 と 再利用性 を高める流れの中で意義ある動きといえる
  • 他の一般的なナレッジグラフプロジェクトと異なり、米国税法および連邦規則に特化した 高品質な本番環境対応構造 として設計されており、同分野での活用度と信頼性が高い
  • JavaScriptおよびJVM言語群（例: Java, Kotlin, Scala, Clojure など）をすべてサポートし、幅広い技術スタックとの互換性 を備える
  • 頻繁なリポジトリ更新とリアルタイム反映体制により最新状態を維持する
  • 法的根拠とオープンソース政策を明確に順守することで、公的機関・民間・個人のいずれも信頼して活用できる基盤を提供する

プロジェクト概要

  • Fact Graphは 本番環境ですぐに活用できるナレッジグラフ であり、主に米国連邦税法（Internal Revenue Code）および関連税法をモデリングすることを目的としている
  • JavaScriptはもちろん、すべてのJVMベース言語（Java, Kotlin, Scala, Clojure など）で利用でき、多様なプラットフォームおよび開発環境に適用できる

リポジトリ活用と開発参加

  • 開発環境およびセットアップ方法はONBOARDING.mdで確認できる
  • 最新バージョン（v3.1）で前バージョンから改善された点は、別文書とリンクで提供されている
  • オープンソースへの貢献方法とガイドはCONTRIBUTING.mdで詳しく案内されている

主な特徴

  • プロジェクトのソースコードは 定期的に更新 され、実際の開発は 非公開リポジトリ で進めた後、レビュー済みの変更のみを本リポジトリ（mainブランチ）へリアルタイムでマージする方式を採用している
  • ScalaTest（テストフレームワーク）、scala-xml（XML実装）を文書内で言及し、主要な依存関係とツールを明確に説明している

法的権利および案内事項

  • このプロジェクトの法的基盤は、複数の 米国連邦法および政策（例: Source Code Harmonization And Reuse in Information Technology Act, Federal Source Code Policy, Digital Government Strategy など）によって整備されている
  • IRSは当該コードの正確性、完全性、機能性について 保証も責任も負わない
  • ソフトウェア利用に関する すべての責任は利用者本人にある（税務結果、計算誤り、データ損失などを含む）
  • オープンソースライセンスおよびサードパーティライセンスの順守 が必要

言語および技術情報

  • ソースコード全体の 99.9%はScala で書かれている
  • そのほか、Makefileなど一部の文字列記述が含まれる

その他情報

  • このプロジェクトでは公式リリースがまだ配布されておらず、235個のスターと11個のフォークがある
  • 合計11人のコントリビューターが参加している

関連記事

1件のコメント

 
GN⁺ 2025-10-17
Hacker Newsのコメント
  • 何か自分が勘違いしているのか、それともこのリポジトリには実際に税法上の<i>fact</i>が含まれていないのか気になる。/demo/all-facts ファイルが「本物の」factとして扱われるべきなのか、XMLのfactファイルは別の場所から入手できるのか知りたい。IRSが税額計算式を定義・管理する方法はかなりクールだし、機械可読な税法という点も本当に興味深い
    • 実際のIRS税法実装は別のリポジトリにある: https://github.com/IRS-Public/direct-file もともとリンクされていたリポジトリは、税務実装とは分離されたfact graphツールを担当している
    • このドキュメントより: "fact辞書を標準化し、税務ロジックを宣言的にモデリングするための正規フォーマットにする"
    • 実データではなく、データベースに対するHTTPインターフェースのように見える
    • 私の理解では、factとは共有された前提や事実を意味する。税法においてこのアプローチは完全に合理的だ
  • TurboTaxは、過度に複雑なインターフェース、節約できるふりをしながら実際にはそうでない攻撃的なデータ収集、そしてIRSに匹敵するほど複雑な料金体系のせいで非常に苛立たしい体験だった。このプロジェクトによって、TurboTaxの市場支配に対抗できる透明でユーザーフレンドリーな代替を、ドメイン専門家や善意ある人たちが簡単に作れるようになってほしい。この問題を改善する良いツールやアプローチに出会った人がいるのか気になる
    • Direct Fileを1年だけ使ったことがあるが、本当に良くて、上で挙げられていた問題点を解決してくれた。その後の動きもあったので心配はいらない 関連記事
    • FreeTaxUSAは本当に素晴らしい
    • TurboTaxの広告はほとんど詐欺に近いレベルだと思う。Freetaxusa.com（関係なし）は同じくらい良くて、本当に無料だ
    • 去年はFree Fill Fillable Formsを連邦と州の両方で使った。どうしてもっと早く使わなかったのか不思議なくらいで、自分で申告書を書くのは怖かったが、自分の状況では本当に簡単だった
  • アメリカの税法がオープンソースで実装されているのを見るのはうれしい。このコードはIRS Direct Fileコードベースの一部で、そのおかげで人々は無料でIRSに直接納税申告できた。今年初めにトランプ政権がこれを打ち切った。Fact Graphはすでに数か月前にオープンソース化されていて、その版はここにある。でも、なぜ2つ目のリポジトリができたのか気になる
    • 私も気になる。おそらく、より汎用的な用途のために独立して使えるよう、direct fileプロジェクトから切り離そうとしているのではないかと思う
    • Direct Fileがなくなったのは今でも残念で、本当に可能性のあるスタートだった
  • これをLLMと組み合わせて、税法について興味深い助言を提供するのに使えるのか気になる。税法について定期的に気軽に質問できたら本当にいいのに
    • patio11はすでに2,000ドル以上節約したらしい。いつかもっと正式なレビュー記事も書くかもしれない（関連スレッド: 1つ目, 2つ目）
    • すでに誰かが税法で学習したモデルを作っていないのか気になる。きっと面白いはずだ
    • 遊びで使うだけならいいかもしれないが、LLMが誤って幻覚を起こして出した税務・法務アドバイスに実際に従うのは絶対にNOPEだ

  • このプロジェクトは米国政府の著作物であり、米国内ではパブリックドメインです<br>「米国内ではパブリックドメイン」というライセンス文言がどういう意味なのか気になる。このソフトウェアは米国外では使えないのだろうか

    • 「米国内ではパブリックドメイン」の意味が気になるなら、文全体を読む必要がある（CC 1.0 Universalの文言の直前にある2文も含めて） <br>> 米国外では使えないのか？ <br>ライセンスは2つのことを説明している:<br> (1) 米国では、米国連邦政府の著作物であるため、別個のライセンスなしでも自動的にパブリックドメインになる <br>(2) 米国外で著作権者が米国連邦政府である場合（特にベルヌ条約の原則を適用する国）には、全世界的な著作権放棄をCC 1.0 Universal宣言によって行っている <br>したがって、実質的には世界中どこでも著作権上の制約なく自由に使える

    • 国によってはパブリックドメインという概念を認めていない。米国では政府著作物の多くがパブリックドメインだ。こうした国際的な法的差異のため、米国政府はパブリックドメインを掲げつつ、同時に国際的にはパブリックドメインに近い意図のライセンスを付与することで目的を達成しようとしている
    • いい質問だ。国ごとに著作権法が違うので、米国外では別のライセンスが適用されることを明確にしようとしているのかもしれない
  • 私にはソースがScalaに見えたが、脳がClojureだと勘違いして、最初の数秒は括弧がない理由を理解できず混乱した
  • Direct Fileのコード公開時には本当に面白くてクールな部分だった。以前のHN議論 とくにそのリリースには今でもかなり良いインラインチュートリアルが残っていて、参考にしやすい チュートリアルへのリンク
  • ルール（税務ルール）がバージョン管理されているのか気になる。確認してみたが見つけられなかった
  • これをどうハックして節税できるのか気になる
  • IRSがまだ存在していること自体に驚く