Install & Compatibility
Where this runs
tested against v1.6.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.10
✕ build_error
1/2 runs
py 3.11
✕ build_error
1/2 runs
py 3.12
✕ build_error
1/2 runs
py 3.13
✕ build_error
1/2 runs
py 3.9
✕ build_error
1/2 runs
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
TabularPredictor
✓ from autogluon.tabular import TabularPredictor
TabularDataset
✓ from autogluon.tabular import TabularDataset
This quickstart demonstrates how to train a `TabularPredictor` on a dataset and then make predictions. It uses a dummy DataFrame for immediate execution, with commented-out lines showing how to load data from AutoGluon's public S3 bucket for a more realistic scenario. The `presets='best'` option instructs AutoGluon to use its best-performing configuration.
import pandas as pd
from autogluon.tabular import TabularPredictor, TabularDataset
# Create dummy dataframes if not using S3 URLs for demonstration
train_data = pd.DataFrame({
'feature_1': [1, 2, 3, 4, 5],
'feature_2': ['A', 'B', 'A', 'C', 'B'],
'target_column': [0, 1, 0, 1, 0]
})
test_data = pd.DataFrame({
'feature_1': [6, 7],
'feature_2': ['C', 'A']
})
# Or load directly from AutoGluon's S3 bucket (uncomment for real usage)
# data_root = 'https://autogluon.s3.amazonaws.com/datasets/Inc/'
# train_data = TabularDataset(data_root + 'train.csv')
# test_data = TabularDataset(data_root + 'test.csv')
# Initialize and train the predictor
predictor = TabularPredictor(label='target_column', path='./AutogluonModels').fit(train_data, presets='best')
# Make predictions
predictions = predictor.predict(test_data)
print("Predictions:\n", predictions)
# Evaluate the model (requires a label column in test_data, not present in dummy test_data)
# Assuming test_data_with_labels exists:
# test_data_with_labels = pd.DataFrame({
# 'feature_1': [6, 7],
# 'feature_2': ['C', 'A'],
# 'target_column': [1, 0]
# })
# leaderboards = predictor.leaderboard(test_data_with_labels, silent=True)
# print("Leaderboard:\n", leaderboards)
Debug
Known issues
breakingModels trained with an older version of AutoGluon are NOT compatible with newer versions. Users must re-train models after upgrading the library.fixRe-train all AutoGluon models after upgrading the `autogluon-tabular` library.
affects: All versions, notably v0.8.2 and v1.5.0 releases explicitly warn about this.
breakingSeveral `TabularPredictor` methods were renamed in v1.3.0. For example, `persist_models` became `persist`, and `get_model_names` became `model_names`.fixUpdate method calls to their new names (e.g., `predictor.persist()` instead of `predictor.persist_models()`). Refer to the v1.3.0 release notes or documentation for a full list of renames.
affects: v1.3.0 and later (deprecated in v1.0.0, raised errors in v1.2.0, removed in v1.3.0).
gotchaPython version support changes: AutoGluon dropped support for Python 3.8 in v1.2.0, while adding support for 3.12. Current versions (1.5.0) support Python 3.10-3.13, with experimental support for 3.13 on Windows.fixEnsure your Python environment uses a supported version (3.10-3.13 for v1.5.0). Check release notes for specific version compatibility.
affects: v1.2.0 onwards for Python 3.8 drop; v1.5.0 for 3.10-3.13 support.
gotchaIf using 'TABPFNV2' model, it is strongly recommended to switch to 'REALTABPFN-V2' due to breaking changes in the underlying TabPFN library. 'REALTABPFN-V2.5' also exists but has a non-commercial license and requires HuggingFace authentication.fixUpdate your model hyperparameters to use 'REALTABPFN-V2' if you were using 'TABPFNV2'. For 'REALTABPFN-V2.5', ensure you understand the licensing and perform the required HuggingFace authentication. Note that 'REALTABPFN-V2.5' is not included in default presets.
affects: v1.5.0 onwards, specific to TabPFN model usage.
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'autogluon.tabular'
This error occurs when the 'autogluon.tabular' module is not installed or not found in the Python environment.
fixInstall the module using pip: 'pip install autogluon.tabular'.
AttributeError: 'super' object has no attribute '__sklearn_tags__'
This error arises due to an incompatibility between XGBoost and scikit-learn when deserializing the model during summary generation.
fixEnsure that both XGBoost and scikit-learn are updated to compatible versions. Refer to the AutoGluon GitHub issue for more details: https://github.com/autogluon/autogluon/issues/5115.
AttributeError: 'XGBClassifier' object has no attribute 'n_classes_'
This error is likely caused by a conflict between the current XGBoost version and AutoGluon.
fixDowngrade to an older XGBoost version to resolve the issue. More information can be found here: https://github.com/autogluon/autogluon/issues/5288.
ImportError: cannot import name 'TabularPrediction' from 'autogluon'
This error often occurs due to a namespace collision in older versions of AutoGluon (e.g., v0.0.14) or an incorrect import path. The class for tabular prediction was renamed or moved to a specific submodule.
fixEnsure you have a recent version of AutoGluon and import `TabularPredictor` and `TabularDataset` directly from `autogluon.tabular`:
`from autogluon.tabular import TabularPredictor, TabularDataset`
ModuleNotFoundError: No module named 'autogluon'
This typically means the `autogluon` package, or its submodules, were not installed correctly or the Python environment is corrupted.
fixReinstall `autogluon` or `autogluon.tabular` in a clean Python virtual environment. For a full tabular installation, use:
`pip install autogluon.tabular[all]`
If issues persist, try installing specific dependencies first:
`pip install -U pip setuptools wheel`
`pip install 'mxnet<2.0.0'`
`pip install autogluon.tabular`
Upgrade
Version history
1.6.1latest on PyPI · released Aug 6, 2026
Audit
Dependencies
PythonrequiredSupported versions for autogluon-tabular are >=3.10 and <3.14. Support for Python 3.13 is experimental on Windows.
lightgbmoptionalIncluded with `[all]` extra for enhanced model performance.
catboostoptionalIncluded with `[all]` extra for enhanced model performance.
xgboostoptionalIncluded with `[all]` extra for enhanced model performance.
fastaioptionalIncluded with `[all]` extra for enhanced model performance.
rayoptionalIncluded with `[all]` extra for distributed computing.
tabpfnoptionalRequired for TabPFN models like `REALTABPFN-V2`, `REALTABPFN-V2.5`. Install via `[all,tabpfn]`.
skexoptionalExperimental dependency to speed up KNN models. Install via `[all,skex]`.