Registry / ai-ml / autogluon-tabular

autogluon-tabular

JSON →
library1.6.1pypypi✓ verified 23d ago

AutoGluon Tabular provides a fast and accurate AutoML library specifically designed for tabular data, allowing users to train and deploy high-accuracy machine learning models with just a few lines of code. Developed by AWS AI, it offers automated stack ensembling, deep learning integration, and handles feature engineering and hyperparameter tuning automatically. The library maintains an active release cadence with major updates every few months and intermediate patch releases.

pip install autogluon.tabular[all]
INSTALL
IMPORT
SIG · AUTOGLUON-TABULAR
A
autogluon-tabular
ai-mlpythonv1.6.1
Install
Import
Disk
Pass rate
0/ 10
Env Coverage0 / 10
glibc
3.93.13
musl
3.93.13
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
musl
glibc
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.
fix
Re-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`.
fix
Update 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.
fix
Ensure 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.
fix
Update 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.
fix
Install 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.
fix
Ensure 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.
fix
Downgrade 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.
fix
Ensure 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.
fix
Reinstall `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]`.
Agent activity
31 hits · last 30 days
node
26
OpenAI (training)
1
Resources