Getting Started on tab-foundry Docs

tab-foundry

Mon, 01 Jan 0001 00:00:00 +0000

A tabular foundation model that generates the data it learns from.

Most tabular foundation models learn from a fixed corpus and stop. You get a .predict() call and a benchmark number, but no control over the data the model trained on, the architecture it uses, or the training loop that produced it.

tab-foundry takes a different approach. It uses dagzoo to generate synthetic tabular datasets, trains them with an active sandwich lane plus a frozen PFN control and historical staged reference lane, benchmarks against real-world tasks, and exports inference bundles you can deploy. You control the full pipeline: what data gets generated, which model surface is active, how training runs, and what gets exported.

Problem Formulation

Mon, 01 Jan 0001 00:00:00 +0000

The primary objects are:

data-side prior parameters $\phi$ for the synthetic task generator
model-side parameters $\theta$ for the sandwich model

Everything else in the repo should be understood as machinery for sampling from the induced task distribution and optimizing the resulting objectives.

Use these alongside this page:

architecture reference: Model Architecture
canonical roadmap: Roadmap
workflow runbooks: Workflows
sweep contract: Sweep Contract
reference index: References

Problem Setup

Let a supervised tabular task be

T = (X_{\mathrm{tr}}, Y_{\mathrm{tr}}, X_{\mathrm{te}}, Y_{\mathrm{te}}, \tau).

with:

Glossary

Mon, 01 Jan 0001 00:00:00 +0000

Use this glossary when architecture, sweep, artifact, and workflow terms start to carry too much repo-specific meaning.

Anchor

The locked comparison run for a sweep. New rows are judged against the anchor unless the queue row explicitly declares a different preserved surface.

Architecture-Screen Surface

The canonical benchmark-facing sandwich surface used for current architecture work. Historical staged surfaces still exist for comparison, but they are no longer the default landing zone for new architecture evidence.

Contributing

Mon, 01 Jan 0001 00:00:00 +0000

Use this guide when you want to make a bounded change without reopening the entire system.

Start with README.md, then go directly to the owner docs that match your question:

README.md for the repo overview and quickstart
docs/workflows.md for command examples and artifact expectations
program.md for the active system-delta sweep contract
docs/development/roadmap.md for research priorities and TF-RD sequencing
docs/development/model-architecture.md for the live model surface
docs/development/codebase-navigation.md for package ownership and entrypoint boundaries
docs/inference.md for export/runtime handoff details
docs/glossary.md for sweep and architecture vocabulary

If a Markdown file and .venv/bin/tab-foundry ... --help disagree, trust the CLI and update the Markdown file.