Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 15 additions & 6 deletions LICENSE-CONTENT
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,14 @@ Creative Commons Attribution 4.0 International

Copyright (c) 2026, Affirm, Inc.

Unless otherwise noted, original educational content in this distribution,
including tutorial prose, original diagrams, and notebook narrative, is
licensed under the Creative Commons Attribution 4.0 International License.
Unless otherwise noted, original tutorial materials in this distribution,
including tutorial prose, original diagrams, notebook narrative, and original
software/code, are licensed under the Creative Commons Attribution 4.0
International License.

Original software/code is additionally available under the Apache License,
Version 2.0, reproduced in LICENSE. Users may choose either CC BY 4.0 or
Apache 2.0 for that original software/code.

License summary: https://creativecommons.org/licenses/by/4.0/
Legal code: https://creativecommons.org/licenses/by/4.0/legalcode
Expand All @@ -15,6 +20,10 @@ Preferred attribution:
Jiarui Xu, Tianming Zhou, Tommy Tai, Joshua Pan, Alexander Statnikov,
and Nitesh Kumar, Affirm, Inc. (2026).

This license does not apply to software or code, which is licensed separately,
or to third-party software, model artifacts, datasets, and adapted materials.
See LICENSE and THIRD_PARTY_NOTICES for those terms.
This grant does not apply to third-party software, model artifacts, datasets,
or adapted materials, which retain their separate terms. It does not relicense
third-party portions of the browser runtime or adapted explorer.
See THIRD_PARTY_NOTICES for those terms.

Affirm names and logos are excluded from these license grants. No trademark
rights are granted.
18 changes: 12 additions & 6 deletions NOTICE
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,19 @@ Table as Prompt: An Interactive Guide to Tabular Foundation Models
Copyright (c) 2026, Affirm, Inc.
All rights reserved.

Unless otherwise noted, software and code artifacts authored for this project
are licensed under the Apache License, Version 2.0.

Unless otherwise noted, original educational content authored for this project
is licensed under the Creative Commons Attribution 4.0 International License.
Unless otherwise noted, original tutorial materials authored for this project,
including prose, diagrams, notebook narrative, and original software/code, are
licensed under the Creative Commons Attribution 4.0 International License.
See LICENSE-CONTENT.

Original software/code is also available under the Apache License, Version 2.0.
Users may choose either CC BY 4.0 or Apache 2.0 for that original software/code.
See LICENSE.

This distribution includes third-party software, model artifacts, and data
under separate terms. See THIRD_PARTY_NOTICES and the license files identified
there. Nothing in the Apache License changes those third-party terms.
there. These grants do not relicense third-party software, model artifacts,
datasets, or adapted materials.

Affirm names and logos are excluded from these license grants. No trademark
rights are granted.
10 changes: 8 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Tabular Foundation Models Tutorial

[Interactive website](https://affirm.github.io/tabular-foundation-models-tutorial/) · [Python notebook](https://colab.research.google.com/github/Affirm/tabular-foundation-models-tutorial/blob/main/materials/notebooks/01_tabicl_primer.ipynb) · [Our guide](#our-interactive-guide) · [Model landscape](#model-landscape) · [Learning resources](#tutorials-and-learning-resources) · [Conference resources](#conference-and-workshop-resources)
**[Interactive website](https://affirm.github.io/tabular-foundation-models-tutorial/)**

[Python notebook](https://colab.research.google.com/github/Affirm/tabular-foundation-models-tutorial/blob/main/materials/notebooks/01_tabicl_primer.ipynb) · [Our guide](#our-interactive-guide) · [Model landscape](#model-landscape) · [Learning resources](#tutorials-and-learning-resources) · [Conference resources](#conference-and-workshop-resources)

Table as Prompt: An Interactive Guide to Tabular Foundation Models - accepted for presentation at the [NeurIPS 2026 Education Track](https://neurips.cc/Conferences/2026/CallforEducationalResources). [Read the paper (PDF, submission version)](materials/website/paper.pdf).

Expand Down Expand Up @@ -108,4 +110,8 @@ Open [localhost:8000](http://localhost:8000/). Serve over HTTP so that module wo

[Browser model provenance](materials/website/model/PROVENANCE.md) documents the checkpoint and export. The [explorer README](materials/tabicl-explainer/README.md) credits the adaptation of Transformer Explainer.

Unless otherwise noted, original software and code are licensed under the [Apache License, Version 2.0](LICENSE), and original educational content is licensed under [Creative Commons Attribution 4.0 International](LICENSE-CONTENT). Copyright (c) 2026, Affirm, Inc. All rights reserved. See [NOTICE](NOTICE) for the project notice and [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES) for the separate terms and attributions that apply to third-party software, model artifacts, adapted materials, and data.
Unless otherwise noted, original tutorial materials, including prose, diagrams, notebook narrative, and original software/code, are available under [Creative Commons Attribution 4.0 International (CC BY 4.0)](LICENSE-CONTENT). Original software/code is also available under the [Apache License, Version 2.0](LICENSE); users may choose either license for that original software/code.

Third-party software, model artifacts, datasets, and adapted materials retain their separate terms; this dual-license grant does not relicense them. Affirm names and logos are excluded from these license grants. No trademark rights are granted.

Copyright (c) 2026, Affirm, Inc. See [NOTICE](NOTICE) for the project notice and [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES) for third-party terms and attributions.
69 changes: 69 additions & 0 deletions THIRD_PARTY_NOTICES
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,22 @@ License: MIT
Copyright (c) 2022 Polo Club of Data Science

The complete MIT license is included at materials/tabicl-explainer/LICENSE.
The website also distributes it at licenses/TRANSFORMER-EXPLAINER.txt.


Iris Dataset
------------

The explorer uses selected UCI Iris records as twelve context rows and three
query examples. Feature measurements remain in centimeters; species names are
encoded as numeric context labels, and query labels are withheld.

Creator: R. A. Fisher
Dataset citation: Fisher, R. (1936). Iris [Dataset]. UCI Machine Learning Repository.
DOI: https://doi.org/10.24432/C56C76
Source: https://archive.ics.uci.edu/dataset/53/iris
License: Creative Commons Attribution 4.0 International (CC BY 4.0)
License URL: https://creativecommons.org/licenses/by/4.0/


Online Shoppers Purchasing Intention Dataset
Expand Down Expand Up @@ -85,3 +101,56 @@ License URL: https://www.nationalarchives.gov.uk/doc/open-government-licence/ver

Contains HM Land Registry data (C) Crown copyright and database right 2025.
This data is licensed under the Open Government Licence v3.0.


Browser Libraries
------------------

The explorer bundles Svelte/SvelteKit and D3 modules with their runtime
dependencies. D3 is ISC licensed; Svelte and SvelteKit are MIT licensed.
Full original license texts and installed versions for these packages and the
D3 dependency graph are included in the repository and deployed website at:

materials/website/licenses/EXPLORER-DEPENDENCIES.txt
Website URL: licenses/EXPLORER-DEPENDENCIES.txt

Sources: https://github.com/d3/d3
https://github.com/sveltejs/svelte
https://github.com/sveltejs/kit

The hero loads Three.js 0.160.0 from jsDelivr rather than bundling it locally.
Source: https://github.com/mrdoob/three.js/tree/r160
License: MIT
Copyright (c) 2010-2023 three.js authors
Full license: materials/website/licenses/THREE.txt
Website URL: licenses/THREE.txt

These licenses are separate from the original tutorial's license grants.
Build-only and notebook dependencies retain their own package license files;
this browser notice is not an inventory of every development dependency.


Web Fonts
---------

Inter and JetBrains Mono are used by the tutorial; Jersey 10 is used by the
explorer. The browser loads these fonts through Google Fonts. Font binaries
are not copied into this repository.

Inter: Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
JetBrains Mono: Copyright 2020 The JetBrains Mono Project Authors
(https://github.com/JetBrains/JetBrainsMono)
Jersey 10: Copyright 2023 The Soft Type Project Authors
(https://github.com/scfried/soft-type-jersey)

License: SIL Open Font License, Version 1.1
Source: https://github.com/google/fonts
Full original notices and license texts are included at:
materials/website/licenses/INTER-OFL.txt
materials/website/licenses/JETBRAINS-MONO-OFL.txt
materials/website/licenses/JERSEY-10-OFL.txt
Website URLs: licenses/INTER-OFL.txt, licenses/JETBRAINS-MONO-OFL.txt,
licenses/JERSEY-10-OFL.txt

The fonts retain their OFL terms and are not relicensed under the tutorial's
CC BY 4.0 / Apache 2.0 grant.
2 changes: 2 additions & 0 deletions assets/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@
October 5, 2026 from https://cdn-assets.affirm.com/images/logo-01-primary.png,
linked by [Affirm's logo resource page](https://businesshub.affirm.com/hc/en-us/articles/4425266541204-Logos-Banners-and-Buttons).
The original asset is 429 × 171 pixels and retains its original colors and transparency.
Affirm names and logos are excluded from the project's CC BY 4.0 and Apache 2.0
license grants. No trademark rights are granted.

The footer of `tabular-tutorial-overview.png` uses this asset at 128 × 51 pixels,
preserving its aspect ratio to the nearest pixel. Only the footer logo region was
Expand Down
21 changes: 15 additions & 6 deletions materials/LICENSE-CONTENT
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,14 @@ Creative Commons Attribution 4.0 International

Copyright (c) 2026, Affirm, Inc.

Unless otherwise noted, original educational content in this distribution,
including tutorial prose, original diagrams, and notebook narrative, is
licensed under the Creative Commons Attribution 4.0 International License.
Unless otherwise noted, original tutorial materials in this distribution,
including tutorial prose, original diagrams, notebook narrative, and original
software/code, are licensed under the Creative Commons Attribution 4.0
International License.

Original software/code is additionally available under the Apache License,
Version 2.0, reproduced in LICENSE. Users may choose either CC BY 4.0 or
Apache 2.0 for that original software/code.

License summary: https://creativecommons.org/licenses/by/4.0/
Legal code: https://creativecommons.org/licenses/by/4.0/legalcode
Expand All @@ -15,6 +20,10 @@ Preferred attribution:
Jiarui Xu, Tianming Zhou, Tommy Tai, Joshua Pan, Alexander Statnikov,
and Nitesh Kumar, Affirm, Inc. (2026).

This license does not apply to software or code, which is licensed separately,
or to third-party software, model artifacts, datasets, and adapted materials.
See LICENSE and THIRD_PARTY_NOTICES for those terms.
This grant does not apply to third-party software, model artifacts, datasets,
or adapted materials, which retain their separate terms. It does not relicense
third-party portions of the browser runtime or adapted explorer.
See THIRD_PARTY_NOTICES for those terms.

Affirm names and logos are excluded from these license grants. No trademark
rights are granted.
18 changes: 12 additions & 6 deletions materials/NOTICE
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,19 @@ Table as Prompt: An Interactive Guide to Tabular Foundation Models
Copyright (c) 2026, Affirm, Inc.
All rights reserved.

Unless otherwise noted, software and code artifacts authored for this project
are licensed under the Apache License, Version 2.0.

Unless otherwise noted, original educational content authored for this project
is licensed under the Creative Commons Attribution 4.0 International License.
Unless otherwise noted, original tutorial materials authored for this project,
including prose, diagrams, notebook narrative, and original software/code, are
licensed under the Creative Commons Attribution 4.0 International License.
See LICENSE-CONTENT.

Original software/code is also available under the Apache License, Version 2.0.
Users may choose either CC BY 4.0 or Apache 2.0 for that original software/code.
See LICENSE.

This distribution includes third-party software, model artifacts, and data
under separate terms. See THIRD_PARTY_NOTICES and the license files identified
there. Nothing in the Apache License changes those third-party terms.
there. These grants do not relicense third-party software, model artifacts,
datasets, or adapted materials.

Affirm names and logos are excluded from these license grants. No trademark
rights are granted.
15 changes: 11 additions & 4 deletions materials/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,9 +78,16 @@ JupyterLab is not part of the locked execution environment.

## Licensing

Unless otherwise noted, original software and code in this standalone materials package are
licensed under the [Apache License, Version 2.0](LICENSE), and original educational content is
licensed under [Creative Commons Attribution 4.0 International](LICENSE-CONTENT). Copyright
(c) 2026, Affirm, Inc. All rights reserved. See [NOTICE](NOTICE) and
Unless otherwise noted, original tutorial materials in this standalone package, including
prose, diagrams, notebook narrative, and original software/code, are available under
[Creative Commons Attribution 4.0 International (CC BY 4.0)](LICENSE-CONTENT). Original
software/code is also available under the [Apache License, Version 2.0](LICENSE); users may
choose either license for that original software/code.

Third-party software, model artifacts, datasets, and adapted materials retain their separate
terms; this dual-license grant does not relicense them. Affirm names and logos are excluded
from these license grants. No trademark rights are granted.

Copyright (c) 2026, Affirm, Inc. See [NOTICE](NOTICE) and
[THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES) for project and third-party terms, including those
for the browser runtime, model artifact, adapted explorer, and datasets.
69 changes: 69 additions & 0 deletions materials/THIRD_PARTY_NOTICES
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,22 @@ License: MIT
Copyright (c) 2022 Polo Club of Data Science

The complete MIT license is included at materials/tabicl-explainer/LICENSE.
The website also distributes it at licenses/TRANSFORMER-EXPLAINER.txt.


Iris Dataset
------------

The explorer uses selected UCI Iris records as twelve context rows and three
query examples. Feature measurements remain in centimeters; species names are
encoded as numeric context labels, and query labels are withheld.

Creator: R. A. Fisher
Dataset citation: Fisher, R. (1936). Iris [Dataset]. UCI Machine Learning Repository.
DOI: https://doi.org/10.24432/C56C76
Source: https://archive.ics.uci.edu/dataset/53/iris
License: Creative Commons Attribution 4.0 International (CC BY 4.0)
License URL: https://creativecommons.org/licenses/by/4.0/


Online Shoppers Purchasing Intention Dataset
Expand Down Expand Up @@ -85,3 +101,56 @@ License URL: https://www.nationalarchives.gov.uk/doc/open-government-licence/ver

Contains HM Land Registry data (C) Crown copyright and database right 2025.
This data is licensed under the Open Government Licence v3.0.


Browser Libraries
------------------

The explorer bundles Svelte/SvelteKit and D3 modules with their runtime
dependencies. D3 is ISC licensed; Svelte and SvelteKit are MIT licensed.
Full original license texts and installed versions for these packages and the
D3 dependency graph are included in the repository and deployed website at:

materials/website/licenses/EXPLORER-DEPENDENCIES.txt
Website URL: licenses/EXPLORER-DEPENDENCIES.txt

Sources: https://github.com/d3/d3
https://github.com/sveltejs/svelte
https://github.com/sveltejs/kit

The hero loads Three.js 0.160.0 from jsDelivr rather than bundling it locally.
Source: https://github.com/mrdoob/three.js/tree/r160
License: MIT
Copyright (c) 2010-2023 three.js authors
Full license: materials/website/licenses/THREE.txt
Website URL: licenses/THREE.txt

These licenses are separate from the original tutorial's license grants.
Build-only and notebook dependencies retain their own package license files;
this browser notice is not an inventory of every development dependency.


Web Fonts
---------

Inter and JetBrains Mono are used by the tutorial; Jersey 10 is used by the
explorer. The browser loads these fonts through Google Fonts. Font binaries
are not copied into this repository.

Inter: Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
JetBrains Mono: Copyright 2020 The JetBrains Mono Project Authors
(https://github.com/JetBrains/JetBrainsMono)
Jersey 10: Copyright 2023 The Soft Type Project Authors
(https://github.com/scfried/soft-type-jersey)

License: SIL Open Font License, Version 1.1
Source: https://github.com/google/fonts
Full original notices and license texts are included at:
materials/website/licenses/INTER-OFL.txt
materials/website/licenses/JETBRAINS-MONO-OFL.txt
materials/website/licenses/JERSEY-10-OFL.txt
Website URLs: licenses/INTER-OFL.txt, licenses/JETBRAINS-MONO-OFL.txt,
licenses/JERSEY-10-OFL.txt

The fonts retain their OFL terms and are not relicensed under the tutorial's
CC BY 4.0 / Apache 2.0 grant.
12 changes: 11 additions & 1 deletion materials/tabicl-explainer/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,13 @@
# TabICL Explainer

Interactive visualization of TabICLv2 inference on fixed UCI Iris examples.
Interactive visualization of TabICLv2 inference on selected
[UCI Iris](https://archive.ics.uci.edu/dataset/53/iris) records.

Dataset citation: Fisher, R. (1936). *Iris* [Dataset]. UCI Machine Learning
Repository. [DOI: 10.24432/C56C76](https://doi.org/10.24432/C56C76).
The dataset is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
Measurements remain in centimeters; species names are encoded as numeric
context labels, and query labels are withheld.

The 12-row context is intentionally compact for tracing. It is outside the
officially documented TabICLv2 pretraining range of 300 to 48K rows. The revised
Expand Down Expand Up @@ -67,3 +74,6 @@ preprocessing, permutations, and temperature 0.9.
Checkpoint source, hashes, runtime behavior, and limitations are documented in
[`../website/model/PROVENANCE.md`](../website/model/PROVENANCE.md). TabICL code
and checkpoint terms remain governed by their upstream sources.

The deployed site includes [third-party notices](../website/THIRD_PARTY_NOTICES.txt)
and [full explorer dependency licenses](../website/licenses/EXPLORER-DEPENDENCIES.txt).
3 changes: 3 additions & 0 deletions materials/tabicl-explainer/src/lib/tabicl.ts
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,9 @@ import { verifySha256 } from '../../../website/js/tabicl/tensor.js';
export const FEATURES = ['Sepal length', 'Sepal width', 'Petal length', 'Petal width'];
export const CLASS_NAMES = ['Setosa', 'Versicolor', 'Virginica'];

// Selected UCI Iris records: Fisher, R. (1936), DOI 10.24432/C56C76, CC BY 4.0.
// Measurements remain in cm; species names are encoded as 0/1/2.
// https://archive.ics.uci.edu/dataset/53/iris
export const CONTEXT = [
{ id: 'E1', x: [5.1, 3.5, 1.4, 0.2], y: 0 },
{ id: 'E2', x: [4.9, 3.0, 1.4, 0.2], y: 0 },
Expand Down
Loading
Loading