▲

IRS가 Fact Graph를 오픈소스로 공개

 (github.com/IRS-Public)
1P by GN⁺ 3일전 | ★ favorite | 댓글 1개
  • 미국 연방국세청(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개의 별(star)과 11개의 포크(fork)가 있음
  • 전체 11명의 컨트리뷰터가 함께 참여 중임
▲
GN⁺ 3일전  [-]
Hacker News 의견
  • 나는 내가 뭔가 헷갈리고 있는 건지, 아니면 이 저장소에 실제로 세법 관련 <i>팩트</i>가 포함되어 있지 않은 건지 궁금함 /demo/all-facts 파일이 “진짜” 팩트로 여겨져야 하는지, XML 팩트 파일은 다른 곳에서 받을 수 있는지 알고 싶음 IRS가 세금 계산식을 정의하고 관리하는 방식은 꽤 멋진데, 기계가 읽을 수 있는 세법이라는 점도 정말 흥미로움
    • 실제 IRS 세법 구현은 별도의 저장소에 존재함 https://github.com/IRS-Public/direct-file 원래 링크된 저장소는 세무 구현과 분리된 fact graph 도구를 담당함
    • 여기 문서에서: "팩트 사전을 표준화해서 세무 논리를 선언적으로 모델링하는 정규 포맷으로 만들기"
    • 실제 데이터가 아니라 데이터베이스에 대한 HTTP 인터페이스처럼 보임
    • 내가 아는 바로는 fact란, 공유된 가정이나 사실을 의미함 세법에서 이러한 접근은 완전히 합리적임
  • TurboTax가 너무 복잡한 인터페이스, 돈을 절약해 주는 척 하면서 사실은 그렇지 않은 공격적인 데이터 수집, IRS 만큼이나 복잡한 요금 구조 때문에 매우 답답한 경험을 했음 이 프로젝트가 TurboTax의 시장 지배력에 도전할 수 있는 투명하고 사용자 친화적인 대안을 도메인 전문가나 좋은 사람들이 쉽게 만들 수 있게 됐으면 좋겠음 혹시 이 문제들을 개선하는 좋은 도구나 접근법을 만난 사람이 있는지 궁금함
    • DirectFile을 단 한 해 사용해봤는데 정말 괜찮았고, 위에서 언급한 문제점들을 해결해줬음 그 후 관련 조치도 이뤄졌으니 걱정할 필요 없음 관련 기사
    • FreeTaxUSA는 정말 훌륭함
    • TurboTax의 광고는 거의 사기에 가까운 수준이라고 생각함 Freetaxusa.com(관계 없음)이 똑같이 좋고 진짜 무료임
    • 작년에 Free Fill Fillable Forms를 연방과 주 모두에 사용했음 왜 진작 안 썼는지 의아했는데, 직접 신고서 작성한다고 해서 겁이 났지만 내 상황에서는 정말 간단했음
  • 미국 세법을 오픈소스로 구현한 걸 보니 반가움 이 코드는 IRS Direct File 코드베이스의 일부였으며, 덕분에 사람들이 무료로 IRS에 바로 세금 신고를 할 수 있었음 올해 초 트럼프 행정부가 이를 중단시켰음 Fact Graph는 이미 몇 달 전에 오픈소스화되었고, 그 버전은 여기에 있음 근데 왜 두 번째 저장소가 생긴 건지 궁금함
    • 나도 궁금함 아마도 일반적인 용도를 위해 독립적으로 쓸 수 있도록 direct file 프로젝트에서 분리하려는 목적이 아닐까 생각함
    • Direct File이 없어져서 여전히 아쉬움, 정말 가능성이 있던 시작이었음
  • LLM과 결합해서 세법에 대해 흥미로운 조언을 제공하는 데 쓸 수 있는지 궁금함 세법에 대해 정기적으로 궁금증을 쉽게 물어볼 수 있으면 정말 좋겠음
    • patio11이 이미 $2,000 이상 절약했다고 함 언젠가 더 정식 후기 글도 쓸 듯함 (관련 스레드: 첫 번째, 두 번째)
    • 이미 누군가 세법으로 학습된 모델을 만들어봤는지 궁금함 분명히 흥미로울 것임
    • 재미로만 사용하는 용도라면 괜찮겠지만, 실제로 LLM이 잘못 환각해서 준 세무/법률 조언을 따라하는 건 절대 NOPE임

  • 이 프로젝트는 미국 정부의 작업물로서 미국 내에서 퍼블릭 도메인임<br> “미국 내에서 퍼블릭 도메인”이라는 라이선스 문구가 무슨 의미인지 궁금함 이 소프트웨어는 미국 외에서는 쓸 수 없는 건지 알고 싶음

    • “미국 내에서 퍼블릭 도메인”의 의미가 궁금하다면, 꼭 전체 문장을 읽어야 함 (CC 1.0 Universal 텍스트 바로 전 두 문장까지도) <br>> 미국 외 지역 사용 불가냐고? <br>라이선스는 두 가지를 설명함:<br> (1) 별도의 라이선스 없이도, 미국 연방 정부 작업물이기 때문에 미국에서는 자동으로 퍼블릭 도메인임 <br>(2) 미국 외에서 저작권자가 미국 연방 정부일 때(특히 베른 협약 하의 원칙을 적용하는 국가) 전 세계적으로 저작권 포기를 CC 1.0 Universal 선언을 통해 하고 있음 <br>그래서 실질적으로 전 세계 어디서나 저작권 구애 없이 자유롭게 쓸 수 있음

    • 일부 국가에서는 퍼블릭 도메인이라는 개념을 인정하지 않음 미국에선 정부 작업물 다수가 퍼블릭 도메인임 이런 국제적 법적 차이로 인해 미국 정부가 퍼블릭 도메인을 내세우고, 동시에 국제적으로는 퍼블릭 도메인과 비슷한 의도의 라이선스를 부여함으로써 목적을 달성하려는 것임
    • 좋은 질문임 국가별로 저작권법이 다르니까, 미국 외에서는 별다른 라이선스가 적용되지 않는다고 명확하게 밝히려는 시도일 수 있음
  • 내 눈에는 소스가 Scala로 보였는데, 내 뇌는 Clojure로 착각해서 처음 몇 초간 괄호 없는 원인을 이해하는 데 혼란이 있었음
  • Direct File 코드 공개 당시 정말 재미있고 멋진 부분이었음 예전 HN 논의 특히 그 릴리스에는 여전히 꽤 괜찮은 인라인 튜토리얼이 남아있어서 참고하기 좋음 튜토리얼 링크
  • 규칙(세무 룰)이 버전 관리되는지 궁금함 확인해보니 못 찾겠음
  • 이걸로 어떻게 해킹해서 돈을 아낄 수 있을지 궁금함
  • 아직 IRS가 존재한다는 사실에 놀람
답변달기