ハクソク

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

Show HN: 自己ホスティング可能なIRSダイレクトファイルの続編

329日前原文(github.com)

概要

OpenFile は、 IRS Direct File をフォークして開発された無料の税務ツール。 Docker を利用して簡単にローカル環境で実行可能。 公式ドキュメントやリファレンスは https://docs.openfile.tax/en/latest/ で公開。 開発は GitHub 上で進行中、ソースコードは自由に閲覧・利用可能。 IRSの開発中止後、 コミュニティ によって継続的にアップデート。

OpenFileとは

  • OpenFile は、 IRS Direct File をベースにしたオープンソースの無料税務ツール
  • IRS （米国内国歳入庁）が開発していたが、現在は公式サポート終了
  • コミュニティ による継続的な開発・保守体制
  • ソースコードは GitHub （openfiletax/openfile）で公開
  • 公式ドキュメントは https://docs.openfile.tax/en/latest/reference.html で参照可能

主な特徴

  • Docker を利用した簡単なセットアップ
    • コマンド例：docker compose up -d
  • クライアントは localhost:3000/df/file で起動
  • JavaScript、 TypeScript、 Java など複数言語で構成
  • オープンライセンス で自由な利用・改変が可能
  • 税務申告 のワークフローをオンラインで完結

利用方法

  • 事前に Docker のインストールが必要
  • リポジトリをクローンし、docker compose up -dで起動
  • ブラウザで localhost:3000/df/file にアクセスし利用開始
  • 詳細な使い方やAPI仕様は 公式ドキュメント を参照

開発・コミュニティ

  • GitHub 上で開発履歴やバグ報告、機能提案が可能
  • スター（Star） や フォーク（Fork） による貢献歓迎
  • 今後の税務シーズン対応に向けて機能拡充予定
  • Pull Request によるコード貢献も活発

技術スタック

  • JavaScript ：約48%
  • TypeScript ：約34%
  • Java ：約15%
  • その他： HTML、 SCSS、 Python など

今後の展望

  • IRS 公式開発終了後も、 OpenFile として独自に発展
  • 新機能追加やバグ修正をコミュニティ主導で継続
  • オープンソース税務ツールとしての普及・活用推進

Hackerたちの意見

これを続けてくれてありがとう、そして遅れて18Fがこれらの実装をオープンソースにしてくれたことに感謝！あなたの努力を制度化できる方法があればいいなと思ってる。ちなみに、ダークモードのブラウザでドキュメントページを見ると、黒い背景に黒い文字が見えるんだけど…（https://docs.openfile.tax/en/latest/）。

└

今日中にドキュメントを直すね、ありがとう。

READMEの中のhttps://docs.openfile.tax/en/latest/direct-file.htmlのリンクが404になってるよ。

└

名前を変えちゃってごめん、こちらが正しいURLだよ - https://docs.openfile.tax/en/latest/reference.html

アメリカ出身じゃないけど、政府のワークフローに関するフォームには関わったことがある。ずっと気になってたのは、なんで人が自分に関する情報を保存して、ソフトウェアがその中から必要な情報を選んでフォームを埋められないのかってこと。そうすれば、必要な情報を確認して、どれを共有するか決められるじゃん。実際、政府は通常扱う情報の種類を標準化できるし、市民が政府に何かを頼むときは、フォームを埋める代わりに、自分のホストした事実データベースを提供して、政府のクエリを実行して結果を出せるはず（確認後にね）。

└

郵便局がこれになり得たと思うけど、政治的な意志がなかったんだろうね。銀行業務と税金、そして郵便システムを分けることで、関心の分離を図ることが創設者たちの頭の中にあったと思う。ワシントン自身がスパイネットワークを運営していて、革命中に兵士や傭兵に追われていたから、これらの懸念は正当だとは言えるけど、あまり時代に合ってないね。革命の時期やその後の連邦時代には、そもそも連邦所得税なんてなかったし。

└

ティム・バーナーズ＝リーがSolidで取り組んでいたことに似てるね（https://solidproject.org/about）。

└

税金は「自己申告」方式で、納税者が税金の評価に関連するすべての事実を申告する責任があるんだ。そして、税金を支払う。時々、あなたのケースが監査の対象に選ばれて、申告した内容が適用される法律に従って正しいかどうかをチェックされるんだ。例えば、小さな商店があるとするよ…それは誰のもの？その場所は賃貸？いくら？賃貸契約は有効で適切？もしかして、申告してるより少ない家賃を払ってる？実際に雇ってる人は本当にいるの？彼らに言ってる通りの金額を支払ってるの？どうやって事実データベースが変なデータを持ってないか確認するの？例えば、燃料に週100ドル払ってると言ってるけど、実際は店が家の隣にあって、毎日その現金をポケットに入れてるだけだったら？この週100ドルの経費を事実データベースに入れ続けたら、政府はどうやって俺が嘘をついてないか知るの？

彼らがリリースしたコードが何なのか、正直よくわからなかった。単にW2が一つだけで株式などがない人のためのフォームフィラーってこと？

└

IRS Direct FileがGitHubに - https://news.ycombinator.com/item?id=44182356 - 2025年6月 https://chrisgiven.com/2025/06/saying-goodbye/ https://chrisgiven.com/2025/05/direct-file-on-github/ https://github.com/IRS-Public/direct-file （議会で交渉中の最新の法案では、Direct Fileを終了させる言語が削除されたけど、状況が流動的なので、もちろんこれが変わる可能性もある。とはいえ、私たちはこれから学んで、ソースコードにアクセスできるようになったことで、みんな良くなったと思うよ。）

└

彼らが公開したコードは、ダイレクトファイルを開発するために必要なすべてのもので、MeF（IRSのオンライン提出API）やSADI（ID.meと統合されたIRSの認証システム）に関するコードは削除されたんだ。ほとんどのコードはバックエンドで、Fact Graph（非常に複雑なルールエンジン）、クライアントアプリ（ダイレクトファイルのフォームとスクリーナー）、州税APIが含まれてる。

コマンドラインがあったら最高だな。いつか時間ができたら、Javaをほこり払ってやってみようかな。

参考までに、ビッグビューティフルビルにはこんな内容が含まれてるよ…「できるだけ早く、そしてこの法律の施行日から30日以内に、財務長官はIRSのダイレクトファイルプログラムが終了することを確実にしなければならない。」（これが投稿した時点での法案のテキストだけど、今は変わってるかもしれないし、間違ってるかもしれないよ。https://www.congress.gov/bill/119th-congress/house-bill/1/te...）

└

政府がどれだけ人間に対して嫌悪感を抱いているか、これ以上の証拠はいらないよ。本当に落ち込む。

それは本当に素晴らしいね。もっとアップボートしたいくらいだよ。これを続けて、サポートを得られるといいな。（ごめん、できるだけJavaScriptを避けることが人生の目標になってるんだ）アメリカ政府がどれだけ無能で役立たずになったか、恥ずかしいよ。