Metadata-Version: 2.1
Name: ai2-tango
Version: 0.4.0rc4
Summary: A library for choreographing your machine learning research.
Home-page: https://github.com/allenai/tango
Author: Allen Institute for Artificial Intelligence
Author-email: contact@allenai.org
License: Apache
Platform: UNKNOWN
Classifier: Intended Audience :: Science/Research
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.7.1
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cached-path (<1.1,>=1.0)
Requires-Dist: PyYAML (<6.1,>=5.4.1)
Requires-Dist: dill
Requires-Dist: base58
Requires-Dist: xxhash
Requires-Dist: filelock (<3.5,>=3.4)
Requires-Dist: click (<9.0,>=7.0)
Requires-Dist: click-help-colors (<0.10,>=0.9.1)
Requires-Dist: tqdm (<4.63,>=4.62)
Requires-Dist: more-itertools (<9.0,>=8.0)
Requires-Dist: sqlitedict
Requires-Dist: glob2 (>=0.7)
Requires-Dist: petname (<3.0,>=2.6)
Requires-Dist: jsonnet (>=0.10) ; sys_platform != "win32"
Provides-Extra: all
Requires-Dist: torch (<1.11,>=1.9) ; extra == 'all'
Requires-Dist: numpy ; extra == 'all'
Requires-Dist: datasets (<2,>=1.12) ; extra == 'all'
Requires-Dist: wandb (<0.13,>=0.12) ; extra == 'all'
Requires-Dist: pytorch-lightning (<1.6,>=1.5) ; extra == 'all'
Provides-Extra: datasets
Requires-Dist: datasets (<2,>=1.12) ; extra == 'datasets'
Provides-Extra: dev
Requires-Dist: flake8 ; extra == 'dev'
Requires-Dist: mypy (==0.920) ; extra == 'dev'
Requires-Dist: types-PyYAML ; extra == 'dev'
Requires-Dist: types-setuptools ; extra == 'dev'
Requires-Dist: black (==21.12b0) ; extra == 'dev'
Requires-Dist: isort (==5.10.1) ; extra == 'dev'
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pytest-sphinx ; extra == 'dev'
Requires-Dist: flaky ; extra == 'dev'
Requires-Dist: pytest-cov ; extra == 'dev'
Requires-Dist: coverage ; extra == 'dev'
Requires-Dist: codecov ; extra == 'dev'
Requires-Dist: twine (>=1.11.0) ; extra == 'dev'
Requires-Dist: setuptools ; extra == 'dev'
Requires-Dist: wheel ; extra == 'dev'
Requires-Dist: Sphinx (==4.3.1) ; extra == 'dev'
Requires-Dist: furo (==2021.11.23) ; extra == 'dev'
Requires-Dist: myst-parser (==0.16.1) ; extra == 'dev'
Requires-Dist: sphinx-copybutton (==0.4.0) ; extra == 'dev'
Requires-Dist: sphinx-autobuild (==2021.3.14) ; extra == 'dev'
Requires-Dist: packaging ; extra == 'dev'
Provides-Extra: examples
Requires-Dist: transformers ; extra == 'examples'
Provides-Extra: pytorch_lightning
Requires-Dist: torch (<1.11,>=1.9) ; extra == 'pytorch_lightning'
Requires-Dist: pytorch-lightning (<1.6,>=1.5) ; extra == 'pytorch_lightning'
Provides-Extra: torch
Requires-Dist: torch (<1.11,>=1.9) ; extra == 'torch'
Requires-Dist: numpy ; extra == 'torch'
Provides-Extra: wandb
Requires-Dist: wandb (<0.13,>=0.12) ; extra == 'wandb'

<div align="center">
<br>
<img src="https://raw.githubusercontent.com/allenai/tango/main/docs/source/_static/tango_final_horizontal.png" width="600"/>
<br>
<br>
<p>
<!-- start tagline -->
AI2 Tango replaces messy directories and spreadsheets full of file versions by organizing experiments into discrete steps that can be cached and reused throughout the lifetime of a research project.
<!-- end tagline -->
</p>
<hr/>
<a href="https://github.com/allenai/tango/actions">
    <img alt="CI" src="https://github.com/allenai/tango/workflows/CI/badge.svg?event=push&branch=main">
</a>
<a href="https://pypi.org/project/ai2-tango/">
    <img alt="PyPI" src="https://img.shields.io/pypi/v/ai2-tango">
</a>
<a href="https://ai2-tango.readthedocs.io/en/latest/?badge=latest">
    <img src="https://readthedocs.org/projects/ai2-tango/badge/?version=latest" alt="Documentation Status" />
</a>
<a href="https://github.com/allenai/tango/blob/main/LICENSE">
    <img alt="License" src="https://img.shields.io/github/license/allenai/tango.svg?color=blue&cachedrop">
</a>
<br/>
</div>

## Quick links

- [Documentation](https://ai2-tango.readthedocs.io/)
- [PyPI Package](https://pypi.org/project/ai2-tango/)
- [Contributing](https://github.com/allenai/tango/blob/main/CONTRIBUTING.md)
- [License](https://github.com/allenai/tango/blob/main/LICENSE)

## Installation

<!-- start install -->

**ai2-tango** requires Python 3.7 or later.

### Installing with `conda`

**ai2-tango** is available on conda-forge. You can install just the base package with

```bash
conda install tango -c conda-forge
```

You can pick and choose from the integrations with one of these:

```bash
conda install tango-datasets -c conda-forge
conda install tango-pytorch_lightning -c conda-forge
conda install tango-torch -c conda-forge
conda install tango-wandb -c conda-forge
```

You can also install everything:

```bash
conda install tango-all -c conda-forge
```

Even though **ai2-tango** itself is quite small, installing everything will pull in a lot of dependencies.
Don't be surprised if this takes a while!


### Installing with `pip`

**ai2-tango** is available [on PyPI](https://pypi.org/project/ai2-tango/). Just run

```bash
pip install ai2-tango
```

To install with a specific integration, such as `torch` for example, run

```bash
pip install ai2-tango[torch]
```

### Installing from source

To install **ai2-tango** from source, first clone [the repository](https://github.com/allenai/tango):

```bash
git clone https://github.com/allenai/tango.git
cd tango
```

Then run

```bash
pip install -e .
```

To install with a specific integration, such as `torch` for example, run

```bash
pip install -e .[torch]
```

### Checking your installation


Run

```bash
tango info
```

to check your installation.

<!-- end install -->

## FAQ

<!-- start faq -->

### Why is the library named Tango?

The motivation behind this library is that we can make research easier by composing it into well-defined steps.  What happens when you choreograph a number of steps together?  Well, you get a dance.  And since our [team's leader](https://nasmith.github.io/) is part of a tango band, "AI2 Tango" was an obvious choice!

<!-- end faq -->

## Team

<!-- start team -->

**ai2-tango** is developed and maintained by the AllenNLP team, backed by [the Allen Institute for Artificial Intelligence (AI2)](https://allenai.org/).
AI2 is a non-profit institute with the mission to contribute to humanity through high-impact AI research and engineering.
To learn more about who specifically contributed to this codebase, see [our contributors](https://github.com/allenai/tango/graphs/contributors) page.

<!-- end team -->

## License

<!-- start license -->

**ai2-tango** is licensed under [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0).
A full copy of the license can be found [on GitHub](https://github.com/allenai/tango/blob/main/LICENSE).

<!-- end license -->


