Skip to content
Useful extra functionality for TensorFlow 2.0 maintained by SIG-addons
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add subpackage for RNN related code. (#189) Apr 18, 2019
static DOC: use logo for SIG/addons (#93) Mar 16, 2019
tensorflow_addons fix test cases (#202) Apr 23, 2019
tf_dependency FIX: build using tf sysconfig (#197) Apr 22, 2019
tools added API docs generator in build_docs.py (#196) Apr 22, 2019
.gitignore Update .gitignore to include intellij project file (*.iml). (#186) Apr 17, 2019
BUILD Add subpackage for RNN related code. (#189) Apr 18, 2019
CODE_OF_CONDUCT.md BUILD: Setup for release (#62) Mar 4, 2019
CONTRIBUTING.md
LICENSE Directory structure for discussion Jan 4, 2019
MANIFEST.in
README.md FIX: build using tf sysconfig (#197) Apr 22, 2019
STYLE_GUIDE.md updated style guide (#157) Apr 15, 2019
WORKSPACE
build_pip_pkg.sh CLN: Simplify Build Script (#181) Apr 18, 2019
configure.sh FIX: build using tf sysconfig (#197) Apr 22, 2019
makefile CLN: move ci_testing into tools dir (#70) Mar 4, 2019
requirements.txt
setup.py Add project description to package and pypi #114 (#129) Apr 3, 2019

README.md




PyPI Status Badge Gitter chat

Official Builds

Build Type Status
Linux Py2 CPU Status
Linux Py3 CPU Status
Linux Py2 GPU Status
Linux Py3 GPU Status
Linux Sanity Check Status

TensorFlow Addons is a repository of contributions that conform to well-established API patterns, but implement new functionality not available in core TensorFlow. TensorFlow natively supports a large number of operators, layers, metrics, losses, and optimizers. However, in a fast moving field like ML, there are many interesting new developments that cannot be integrated into core TensorFlow (because their broad applicability is not yet clear, or it is mostly used by a smaller subset of the community).

Maintainers

Subpackage Maintainers Contact Info
tfa.activations SIG-Addons addons@tensorflow.org
tfa.image
tfa.layers SIG-Addons addons@tensorflow.org
tfa.losses SIG-Addons addons@tensorflow.org
tfa.optimizers SIG-Addons addons@tensorflow.org
tfa.rnn Google @qlzh727
tfa.seq2seq Google @qlzh727
tfa.text

Core Concepts

Standardized API within Subpackages

User experience and project maintainability are core concepts in TF-Addons. In order to achieve these we require that our additions conform to established API patterns seen in core TensorFlow.

Periodic Evaluation of Subpackages

Based on the nature of this repository, there will be contributions that in time become dated and unused. In order to keep the project maintainable, SIG-Addons will perform periodic reviews and deprecate contributions which will be slated for removal. More information will be available after we submit a formal request for comment.

Examples

See tensorflow_addons/examples/ for end-to-end examples of various addons.

Installation

Stable Builds

To install the latest version, run the following:

pip install tensorflow-addons

Note: You will also need tensorflow==2.0.0.a0 installed.

To use addons:

import tensorflow as tf
import tensorflow_addons as tfa

Installing from Source

You can also install from source. This requires the Bazel build system.

Note: If building from master you must install tf-nightly-2.0-preview in the process.

git clone https://github.com/tensorflow/addons.git
cd addons

# This script links project with TensorFlow dependency
./configure.sh

bazel build build_pip_pkg
bazel-bin/build_pip_pkg artifacts

pip install artifacts/tensorflow_addons-*.whl

Contributing

TF-Addons is a community led open source project. As such, the project depends on public contributions, bug-fixes, and documentation. Please see contribution guidelines for a guide on how to contribute. This project adheres to TensorFlow's code of conduct. By participating, you are expected to uphold this code.

Community

License

Apache License 2.0

You can’t perform that action at this time.