ハクソク

世界を動かす技術を、日本語で。

IRSがファクトグラフをオープンソース化しました

222日前原文(github.com)

概要

Fact Graph は、米国の税法をモデリングするための 知識グラフ。 このリポジトリの コード利用は自己責任。 IRS は内容の正確性や完全性を保証しない。 オープンソースライセンス 遵守が必要。 セットアップや貢献方法は 関連ドキュメント 参照。

免責事項

  • Internal Revenue Service (IRS) は、本リポジトリ内のコードの 正確性・完全性・機能性 を保証しない。
  • IRSは、 外部利用者 （個人・開発者・組織）によるコード利用に伴う 一切の責任を負わない。
  • 税務上の影響、計算ミス、データ損失、その他の結果 についても、IRSは責任を負わない。
  • 本リポジトリのコード利用は 自己責任。
  • ユーザーは、 オープンソースライセンスやサードパーティライセンス の遵守が必要。

Fact Graphとは

  • Fact Graph は、米国 Internal Revenue Code や関連税法をモデリングするための 本番運用対応知識グラフ。
  • JavaScript や JVM言語 （Java、Kotlin、Scala、Clojure等）で利用可能。
  • 法的知識管理 や 税法解析 用途に最適。

オンボーディングとセットアップ

  • 環境構築や開発者向けセットアップ は、 ONBOARDING.md を参照。
  • Fact Graph 3.1 ADR で、 最新バージョン および 2025年以降の変更点 を解説。
  • 旧バージョンとv3.1の違い は、リポジトリ内の 比較ドキュメント を参照。

コントリビューション

  • 貢献方法やガイドライン は、 CONTRIBUTING.md に詳細記載。

リポジトリ更新頻度

  • 本リポジトリは 高頻度で更新。
  • 開発は プライベートリポジトリ で進行し、 承認済み変更 がリアルタイムで main に反映。

参考ドキュメント

  • ScalaTest ：本リポジトリの テストフレームワーク。
  • scala-xml ：標準 XML実装。APIドキュメントは簡素だが、 関数定義に優れた例 あり。

Hackerたちの意見

アメリカの税法のオープンソース実装が見られるのは嬉しいね！これはIRSのダイレクトファイルのコードベースの一部で、無料で税金を申告できる仕組みだったんだ。トランプ政権によって今年の初めにキャンセルされちゃったけど。ファクトグラフは数ヶ月前にオープンソース化されてて、そのバージョンはここにあるよ: https://github.com/IRS-Public/direct-file/tree/main/direct-f... なんで別のリポジトリが作られたのか気になるな。

└

確かにそう思う。もしかしたら、一般利用のためにスタンドアロンにするつもりなのかもね。ダイレクトファイルプロジェクトの一部だけじゃなくて。

└

ダイレクトファイルがなくなったのはまだ残念だな。すごく期待できるスタートだったのに…

これをLLMと組み合わせて面白い税金アドバイスができるのか気になるな。税法について定期的に質問したいな…

└

誰かが税法に基づいてモデルをトレーニングしてるかどうか気になるな。絶対面白いと思う。

└

エンターテイメント目的ならいいけどね。「幻覚を見てるかもしれないLLMからの税金/法律アドバイスを実際に受ける」ってのは、NOPEのカテゴリに入れちゃうよ。

└

patio11はすでに2000ドル以上節約したみたいだね。いつかもっと正式なまとめを書いてくれるかも。(ここにいくつかスレッドがあるよ https://x.com/patio11/status/1977425626584711668 とここに https://x.com/patio11/status/1978168404793037087 )

5ヶ月前のダイレクトファイルのコードドロップは本当に楽しかったな。https://news.ycombinator.com/item?id=44131901 特に、リリースにまだ残ってる結構いいインラインチュートリアルがあるよ: https://github.com/IRS-Public/direct-file/blob/main/direct-f...

まだIRSがあるって知って驚いた。

アメリカ政府の作品として、このプロジェクトはアメリカ国内でパブリックドメインにあります。「アメリカ国内で」というライセンスはどういう意味ですか？これって、このソフトウェアはアメリカの外では使えないってこと？

└

いい質問だね。著作権法は国ごとに違うから、アメリカの外ではライセンスが主張されてないってことを明確にしたいだけかもね。

└

「アメリカ国内で」というライセンスはどういう意味ですか？そのままの意味だよ。全体を読まないとダメだよ（少なくともCC 1.0ユニバーサルのテキストの前の2文は読まないと）。最初の文の一部だけじゃダメ。 > これって、このソフトウェアはアメリカの外では使えないってこと？いいえ。ライセンスは2つのことを説明してる： (1) ライセンスがなければ、これは自動的にアメリカでパブリックドメインになる。なぜなら、これは連邦政府の作品だから。 (2) 連邦政府は、アメリカの外で著作権を放棄していて、これはCC 1.0ユニバーサル宣言を通じて行われてる（そのテキストも含まれてる）。だから、法律的に可能な限り、これは世界中で著作権フリーだよ。

└

一部の国ではパブリックドメイン作品の概念を認めてないんだ。アメリカでは、多くの政府の作品が法律上パブリックドメインになってる。これが、パブリックドメインを法的概念として認めてない国々との国際的な複雑さを生んでる。それでも、アメリカは国際的に利用可能にしたいと思ってる。これらの矛盾する要件を満たすために、アメリカ政府はアメリカの法律を満たすために国内でパブリックドメインにしてる。そして、パブリックドメインの意図に近いライセンスの下で国際的に提供してるけど、法的に有効なものとして認められてるんだ。

自分がバカなのかな、それともこれには税法に関する事実が含まれてないの？/demo/all-factsファイルは「本当の」事実を示すものなの？XMLの事実ファイルは別の場所にあるの？IRSが税計算を定義して維持する方法を見るのは面白いけど、機械可読の税法も面白そうだよね。

└

実際のIRS税法の実装は、ここにある別のリポジトリにあるよ：https://github.com/IRS-Public/direct-file。元々リンクされてたリポジトリは、税法の実装から切り離された事実グラフのツールだね。

└

私の知る限り、事実ってのは共有された仮定を意味するだけだよ。税法に関しては、これは全く合理的だと思う。

└

https://github.com/IRS-Public/fact-graph/blob/main/docs/fact...: > 税金ロジックを宣言的にモデル化するための標準的な形式として、ファクト辞書を標準化する

Scalaが言及されたね。

TurboTaxの複雑すぎるインターフェースや、金を節約するという名目でのデータ収集（実際にはそうでもない）や、IRSの複雑さに匹敵する価格設定にイライラした経験があるよ。この取り組みが、専門家や良い人たちがTurboTaxの市場支配に挑戦するための透明でユーザーフレンドリーな代替品を作れるくらい良いものであってほしいな。これらの問題に取り組む有望なツールやアプローチに出会った人いる？

└

DirectFileは、使えた1年間はかなり良かったし、あなたの懸念にも対応してたよ。心配しないで、もうその問題は解決済みだから。

└

FreeTaxUSAは本当に素晴らしいよ！

└

TurboTaxの広告は、私の意見では詐欺ギリギリだね。freetaxusa.com（関係ないけど）は同じくらい良くて、ちゃんと無料だよ。

└

H&R Blockのソフトウェアの方がいいと思う。

└

Cash App Taxes

目にはScalaが入ってたけど、頭の中はClojureを考えてたから、最初の数秒はちょっと混乱したよ。ソース見てたら、なんで括弧がないの？って思った。