EagerPy: Writing Code That Works Natively with PyTorch, TensorFlow, JAX, and NumPy
EagerPy is a Python framework that lets you write code that automatically works natively with PyTorch, TensorFlow, JAX, and NumPy. EagerPy is also great when you work with just one framework but prefer a clean and consistent API that is fully chainable, provides extensive type annotions and lets you write beautiful code.
🔥 Design goals
Native Performance: EagerPy operations get directly translated into the corresponding native operations.
Fully Chainable: All functionality is available as methods on the tensor objects and as EagerPy functions.
Type Checking: Catch bugs before running your code thanks to EagerPy’s extensive type annotations.
📖 Documentation
Learn more about EagerPy in the documentation.
🚀 Quickstart
pip install eagerpyEagerPy requires Python 3.6 or newer. Besides that, all essential dependencies are automatically installed. To use it with PyTorch, TensorFlow, JAX, or NumPy, the respective framework needs to be installed separately. These frameworks are not declared as dependencies because not everyone wants to use and thus install all of them and because some of these packages have different builds for different architectures and CUDA versions.
🎉 Example
import torch
x = torch.tensor([1., 2., 3., 4., 5., 6.])
import tensorflow as tf
x = tf.constant([1., 2., 3., 4., 5., 6.])
import jax.numpy as np
x = np.array([1., 2., 3., 4., 5., 6.])
import numpy as np
x = np.array([1., 2., 3., 4., 5., 6.])
# No matter which framwork you use, you can use the same code
import eagerpy as ep
# Just wrap a native tensor using EagerPy
x = ep.astensor(x)
# All of EagerPy's functionality is available as methods
x = x.reshape((2, 3))
x.flatten(start=1).square().sum(axis=-1).sqrt()
# or just: x.flatten(1).norms.l2()
# and as functions (yes, gradients are also supported!)
loss, grad = ep.value_and_grad(loss_fn, x)
ep.clip(x + eps * grad, 0, 1)
# You can even write functions that work transparently with
# Pytorch tensors, TensorFlow tensors, JAX arrays, NumPy arrays
def my_universal_function(a, b, c):
# Convert all inputs to EagerPy tensors
a, b, c = ep.astensors(a, b, c)
# performs some computations
result = (a + b * c).square()
# and return a native tensor
return result.raw🗺 Use cases
Foolbox Native, the latest version of Foolbox, a popular adversarial attacks library, has been rewritten from scratch using EagerPy instead of NumPy to achieve native performance on models developed in PyTorch, TensorFlow and JAX, all with one code base.
EagerPy is also used by other frameworks to reduce code duplication (e.g. GUDHI) or to compare the performance of different frameworks.
📄 Citation
If you use EagerPy, please cite our paper using the this BibTex entry:
@article{rauber2020eagerpy,
title={{EagerPy}: Writing Code That Works Natively with {PyTorch}, {TensorFlow}, {JAX}, and {NumPy}},
author={Rauber, Jonas and Bethge, Matthias and Brendel, Wieland},
journal={arXiv preprint arXiv:2008.04175},
year={2020},
url={https://eagerpy.jonasrauber.de},
}🐍 Compatibility
We currently test with the following versions:
PyTorch 1.4.0
TensorFlow 2.1.0
JAX 0.1.57
NumPy 1.18.1
1 maintainer
Metadata
1 maintainer
Release files for eagerpy 0.30.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| eagerpy-0.30.0.tar.gz | 23.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| eagerpy-0.30.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 54.2 kB
Release files / eagerpy-0.30.0.tar.gz
| Download URL | eagerpy-0.30.0.tar.gz |
|---|---|
| Size | 23.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
014c02b5a7f7e19f8471885cf8aa469f2e9cf518c88400f20b6b8db83d413106
|
|
BLAKE2b-256 checksum How to use checksums |
03333bc665b3438fed5af8e95ec0ad04c7b12a228b36246ba4981031022f783d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.0 CPython/3.6.14
|
Release files / eagerpy-0.30.0-py3-none-any.whl
| Download URL | eagerpy-0.30.0-py3-none-any.whl |
|---|---|
| Size | 31.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
79c461b04577f02bf3b48191b2f911b55521204df99ec02288d96bfa34f13d80
|
|
BLAKE2b-256 checksum How to use checksums |
e0b7445e74a70503630a9d3c58563da1f0c831532d45bd5987b861f562826ea4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.0 CPython/3.6.14
|
