{"id":4446,"library":"autogluon","title":"AutoGluon","description":"AutoGluon is an open-source AutoML library developed by AWS AI, designed for fast and accurate machine learning with minimal code. It automates model selection, hyperparameter tuning, and ensemble creation across various data types, including tabular, time series, and multimodal data. The current version is 1.5.0, with a rapid release cadence, often introducing significant performance improvements, new models, and expanded functionalities.","status":"active","version":"1.5.0","language":"en","source_language":"en","source_url":"https://github.com/autogluon/autogluon/","tags":["machine learning","automl","tabular","time series","multimodal","deep learning","aws","python"],"install":[{"cmd":"pip install autogluon","lang":"bash","label":"Basic Installation"},{"cmd":"pip install autogluon[all]","lang":"bash","label":"Full Installation (includes common optional dependencies)"},{"cmd":"pip install autogluon.tabular[tabarena]","lang":"bash","label":"Tabular with State-of-the-Art Models (e.g., TabPFN, TabDPT)"}],"dependencies":[{"reason":"Core data structure (TabularDataset inherits from DataFrame).","package":"pandas","optional":false},{"reason":"Fundamental numerical computing library.","package":"numpy","optional":false},{"reason":"Required for neural network models and GPU acceleration. Often included with `[all]` or specific module installs.","package":"torch","optional":true},{"reason":"Gradient Boosting models, often included with `[all]` or specific module installs.","package":"lightgbm, catboost, xgboost","optional":true},{"reason":"Used for parallel processing and distributed training, often included with `[all]`.","package":"ray","optional":true}],"imports":[{"symbol":"TabularPredictor, TabularDataset","correct":"from autogluon.tabular import TabularPredictor, TabularDataset"},{"symbol":"TimeSeriesPredictor, TimeSeriesDataFrame","correct":"from autogluon.timeseries import TimeSeriesPredictor, TimeSeriesDataFrame"},{"symbol":"MultiModalPredictor","correct":"from autogluon.multimodal import MultiModalPredictor"}],"quickstart":{"code":"import pandas as pd\nfrom autogluon.tabular import TabularPredictor, TabularDataset\n\n# Load example data (using a public dataset URL)\ndata_url = 'https://raw.githubusercontent.com/mli/ag-docs/main/knot_theory/'\ntrain_data = TabularDataset(f'{data_url}train.csv')\ntest_data = TabularDataset(f'{data_url}test.csv')\n\nlabel = 'signature'\npredictor = TabularPredictor(label=label, path='AutogluonModels').fit(train_data, presets='high_quality')\npredictions = predictor.predict(test_data)\n\nprint(\"Top 5 predictions:\")\nprint(predictions.head())\nprint(f\"Predictor leaderboards:\\n{predictor.leaderboard(test_data, silent=True)}\")","lang":"python","description":"This quickstart demonstrates how to use AutoGluon's `TabularPredictor` to train a high-accuracy classification model and make predictions on new data with just a few lines of code. It automatically handles feature engineering, model selection, and hyperparameter tuning."},"warnings":[{"fix":"Re-train all AutoGluon models using the new AutoGluon version.","message":"Models trained with an older version of AutoGluon are not guaranteed to be compatible with newer versions. Users must re-train models after upgrading AutoGluon to prevent issues.","severity":"breaking","affected_versions":"All major and minor version upgrades (e.g., 0.x to 1.x, 1.0 to 1.1)."},{"fix":"Ensure your Python environment is between 3.10 and 3.12 (inclusive) for stable usage. If using Python 3.13, be aware of potential experimental features or platform-specific issues.","message":"Python 3.8 support was dropped in AutoGluon v1.2.0. Additionally, Python 3.13 support is currently experimental in v1.5.0, with potential limitations on Windows.","severity":"breaking","affected_versions":"v1.2.0+"},{"fix":"Update method calls to their new names: `persist_models` -> `persist`, `unpersist_models` -> `unpersist`, `get_model_names` -> `model_names`, `get_model_best` -> `model_best`, `get_pred_from_proba` -> `predict_from_proba`, etc. Refer to the AutoGluon v1.3.0 release notes for a complete list.","message":"Several `TabularPredictor` methods were deprecated in v1.0.0 (e.g., `persist_models`, `get_model_names`), began raising errors in v1.2.0, and were completely removed in v1.3.0.","severity":"breaking","affected_versions":"v1.3.0+"},{"fix":"Explicitly specify the `dry_run` argument (e.g., `predictor.delete_models(dry_run=True)`) to maintain current behavior or `predictor.delete_models(dry_run=False)` to enable actual deletion.","message":"The default behavior of `TabularPredictor.delete_models()` will change from `dry_run=True` to `dry_run=False` in a future release. A `FutureWarning` is logged since v1.3.0.","severity":"deprecated","affected_versions":"v1.3.0+"},{"fix":"Use machines with ample RAM. For tabular data, GPUs are often not critical, but more memory is. Consider reducing `presets` quality, `time_limit`, or subsampling data for initial runs. Set `max_memory` parameter in `predictor.persist()` carefully.","message":"AutoGluon (especially `TabularPredictor`) can be memory-intensive, particularly with large datasets or complex ensembles. Out-of-memory errors are common.","severity":"gotcha","affected_versions":"All versions"},{"fix":"If experiencing issues, uninstall `libomp` via brew and follow AutoGluon's specific instructions for installing a compatible version of `libomp`.","message":"On macOS, LightGBM and XGBoost (used by AutoGluon) can experience segmentation faults or instability if `libomp` is installed via `brew install libomp`.","severity":"gotcha","affected_versions":"All versions on macOS"}],"env_vars":null,"last_verified":"2026-04-12T00:00:00.000Z","next_check":"2026-07-11T00:00:00.000Z"}