autogluon

Pre-release

This release is a pre-release and may not be stable for production use.

AutoML for Image, Text, Time Series, and Tabular Data

Install Instructions | Documentation (Stable | Latest)

AutoGluon automates machine learning tasks enabling you to easily achieve strong predictive performance in your applications. With just a few lines of code, you can train and deploy high-accuracy machine learning and deep learning models on image, text, time series, and tabular data.

Example

# First install package from terminal:
# pip install -U pip
# pip install -U setuptools wheel
# pip install autogluon  # autogluon==1.0.0

from autogluon.tabular import TabularDataset, TabularPredictor
train_data = TabularDataset('https://autogluon.s3.amazonaws.com/datasets/Inc/train.csv')
test_data = TabularDataset('https://autogluon.s3.amazonaws.com/datasets/Inc/test.csv')
predictor = TabularPredictor(label='class').fit(train_data, time_limit=120)  # Fit models for 120s
leaderboard = predictor.leaderboard(test_data)

AutoGluon Task	Quickstart	API
TabularPredictor
MultiModalPredictor
TimeSeriesPredictor

Resources

See the AutoGluon Website for documentation and instructions on:

Installing AutoGluon
Learning with tabular data
- Tips to maximize accuracy (if benchmarking, make sure to run fit() with argument presets='best_quality').
Learning with multimodal data (image, text, etc.)
Learning with time series data

Refer to the AutoGluon Roadmap for details on upcoming features and releases.

Train/Deploy AutoGluon in the Cloud

Contributing to AutoGluon

We are actively accepting code contributions to the AutoGluon project. If you are interested in contributing to AutoGluon, please read the Contributing Guide to get started.

Citing AutoGluon

If you use AutoGluon in a scientific publication, please cite the following paper:

Erickson, Nick, et al. "AutoGluon-Tabular: Robust and Accurate AutoML for Structured Data." arXiv preprint arXiv:2003.06505 (2020).

BibTeX entry:

@article{agtabular,
  title={AutoGluon-Tabular: Robust and Accurate AutoML for Structured Data},
  author={Erickson, Nick and Mueller, Jonas and Shirkov, Alexander and Zhang, Hang and Larroy, Pedro and Li, Mu and Smola, Alexander},
  journal={arXiv preprint arXiv:2003.06505},
  year={2020}
}

If you are using AutoGluon Tabular's model distillation functionality, please cite the following paper:

Fakoor, Rasool, et al. "Fast, Accurate, and Simple Models for Tabular Data via Augmented Distillation." Advances in Neural Information Processing Systems 33 (2020).

BibTeX entry:

@article{agtabulardistill,
  title={Fast, Accurate, and Simple Models for Tabular Data via Augmented Distillation},
  author={Fakoor, Rasool and Mueller, Jonas W and Erickson, Nick and Chaudhari, Pratik and Smola, Alexander J},
  journal={Advances in Neural Information Processing Systems},
  volume={33},
  year={2020}
}

If you use AutoGluon's multimodal text+tabular functionality in a scientific publication, please cite the following paper:

Shi, Xingjian, et al. "Multimodal AutoML on Structured Tables with Text Fields." 8th ICML Workshop on Automated Machine Learning (AutoML). 2021.

BibTeX entry:

@inproceedings{agmultimodaltext,
  title={Multimodal AutoML on Structured Tables with Text Fields},
  author={Shi, Xingjian and Mueller, Jonas and Erickson, Nick and Li, Mu and Smola, Alex},
  booktitle={8th ICML Workshop on Automated Machine Learning (AutoML)},
  year={2021}
}

If you use AutoGluon's time series forecasting functionality in a scientific publication, please cite the following paper:

@inproceedings{agtimeseries,
  title={{AutoGluon-TimeSeries}: {AutoML} for Probabilistic Time Series Forecasting},
  author={Shchur, Oleksandr and Turkmen, Caner and Erickson, Nick and Shen, Huibin and Shirkov, Alexander and Hu, Tony and Wang, Yuyang},
  booktitle={International Conference on Automated Machine Learning},
  year={2023}
}

AutoGluon for Hyperparameter Optimization

AutoGluon's state-of-the-art tools for hyperparameter optimization, such as ASHA, Hyperband, Bayesian Optimization and BOHB have moved to the stand-alone package syne-tune.

To learn more, checkout our paper "Model-based Asynchronous Hyperparameter and Neural Architecture Search" arXiv preprint arXiv:2003.10865 (2020).

@article{abohb,
  title={Model-based Asynchronous Hyperparameter and Neural Architecture Search},
  author={Klein, Aaron and Tiao, Louis and Lienart, Thibaut and Archambeau, Cedric and Seeger, Matthias},
  journal={arXiv preprint arXiv:2003.10865},
  year={2020}
}

License

This library is licensed under the Apache 2.0 License.

Metadata

Release files for autogluon 1.0.1b20231221

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for autogluon 1.0.1b20231221
File	Size	Uploaded
autogluon-1.0.1b20231221.tar.gz	5.5 kB	Dec 21, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for autogluon 1.0.1b20231221
File	Interpreter	ABI	Platform	Reset
autogluon-1.0.1b20231221-py3-none-any.whl 10.0 kB Dec 21, 2023	Python 3	none	any	Details

Total release size: 15.5 kB

Release files / autogluon-1.0.1b20231221.tar.gz

Download URL	autogluon-1.0.1b20231221.tar.gz
Size	5.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`b3177146bd16893e6ffdf0429d1ec6a49d0967841d0a6782069c4d5ca6f49373`
BLAKE2b-256 checksum How to use checksums	`913848573c2a2fc7dc04c623f4956153cecf1c5de799b9b9dd5b73570f6d0c3d`
Upload date	Dec 21, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.8.18`

Release files / autogluon-1.0.1b20231221-py3-none-any.whl

Download URL	autogluon-1.0.1b20231221-py3-none-any.whl
Size	10.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9c631401cbbfffb21f3a6ba2c209bdf0771f2d3193ee2f32184f0b96738bfffe`
BLAKE2b-256 checksum How to use checksums	`63457bc47a0e0ecfb6caea8b3095521263078fdd9ffd1f750deed2665ba7b070`
Upload date	Dec 21, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.8.18`