Talos has moved to its next generation. Talos 2 is in active maintenance. The established Talos 1.x series will remain supported at least until 2028. To keep using the latest 1.x release, install python -m pip install 'talos==1.4' 'ipython<9' in a separate Python 3.10 or 3.11 environment. The maintainer reports no breaking bug found or reported in Talos 1.x during the past two years.

Talos

Hyperparameter experiments with Keras, TensorFlow and PyTorch.

Talos · Key features · Examples · Install · Support · Docs · Issues · Cite · License · Download

Talos helps you turn the model you already have into a repeatable parameter experiment. You keep control of your Keras, TensorFlow or PyTorch model and its training code. Talos runs the candidate settings, records histories and helps you inspect, select and recover trained models.

Talos is made for researchers, data scientists and data engineers who want to remain in complete control of their models, with less time spent hopping between parameter settings. Start in a notebook with the familiar Scan interface. When an experiment needs a reusable definition, use a single Python file, a manifest and the CLI.

The comparison uses actual model code and the real Iris dataset. Open the paired source, or follow the first-sweep guide. The brief training runs demonstrate the interface; they do not establish model performance.

Key features

• Keras, TensorFlow/tf.keras and PyTorch, with framework imports kept optional.
• The familiar Scan, Analyze/Reporting, Predict, Evaluate, Deploy and Restore interfaces.
• Grid and sampled searches, reducers, custom strategies and local control files.
• Notebook workflows, single-file experiment definitions and a CLI on one executor.
• Content-addressed manifests, trial histories, source and data identities, checkpoints and intervention records.
• Trained model recovery, with explicit factories or custom objects where the framework requires them.

You choose the data, splits, training method and evaluation protocol. Talos records the experiment around that work. See the workflow overview, interface reference and migration guide.

Examples

The original notebook paths remain a good way to get to know Talos:

Iris SFD and manifest recovery adds caller-owned data, queue control and resumable CLI execution, with working Keras, TensorFlow and PyTorch variants.

For a native single-file definition, start with Keras, TensorFlow or PyTorch. The SFD and CLI guide takes the experiment from Python to a reproducible manifest.

The original short example and workflow illustration remain available. The historical README preserves the original Field Report reference. Use the maintained notebooks and User manual for current behavior.

Install

Talos 2 is currently available from the development branch. PyPI still serves the established Talos 1.4 release.

python -m pip install 'talos[tensorflow] @ git+https://github.com/autonomio/talos@master'
python -m pip install 'talos[keras,tensorflow] @ git+https://github.com/autonomio/talos@master'
python -m pip install 'talos[torch] @ git+https://github.com/autonomio/talos@master'

Choose the line for your framework. The core supports Python 3.10-3.13; modern Keras and TensorFlow require Python 3.11 or newer. For research, retain the resolved source commit or install from an exact reviewed commit. Installation options covers backends and optional plotting and sampler dependencies.

For the established release:

Install python -m pip install 'talos==1.4' 'ipython<9'.

Use its own Python 3.10 or 3.11 environment. The ipython<9 constraint keeps its plotting dependency compatible; the unchanged 1.4 wheel is verified with Python 3.11 and IPython 8.39.0. This release uses the historical TensorFlow 2.14.1 dependency set; backend compatibility explains the legacy lane and its known upstream advisories.

How to get support

A useful issue includes your Talos and framework versions, the smallest reproducible callback or SFD, the exact command and traceback, and the expected result. The help guide gives the full format.

License

Talos is released under the MIT License. NOTICE preserves required upstream attribution.

Citations

If you use Talos in published work, please cite the software version you used. The maintainer reports Talos use in at least 1,000 research papers.

GitHub's Cite this repository menu reads CITATION.cff. Download BibTeX for your bibliography. The citation guide explains version-specific references and experiment records. For a released version, use that release's citation file. For development code, record the full Git commit and use a permalink to it.

In the methods or supplementary material, retain the Talos and framework versions, the caller source, data provenance and split, seed, parameter space, search strategy and metric direction. When using a manifest, include its content identifier; also retain the run directory identifier and identity_hash from metadata.json. Keep the manifest and run records with the research artifacts so another researcher can identify the experiment that produced the reported result.

The original citation remains available for earlier work:

Autonomio Talos [Computer software]. (2024). Retrieved from https://github.com/autonomio/talos.

Earlier README citation versions: 2018, 2019, 2020, 2024.