Skip to content

Commit 4740013

Browse files
dbortfacebook-github-bot
authored andcommitted
Audit and update the pip package metadata (#3476)
Summary: Pull Request resolved: #3476 Fill out the recommended `project` keys, most of which will affect the web page that PyPI will render for the `executorch` package. See https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#about-your-project for the latest guidance. Use https://github.com/pytorch/pytorch/blob/a21327e0b03cc18850a0608be2d9c5bd38fd4646/setup.py#L1394 as a guide for the actual values. Add a README-wheel.md file that will be included in the wheel, and will become the main page contents on PyPI. Test Plan: * Installed the package with `./install_requirements.sh` * Looked at the files under ~/miniconda3/envs/executorch/lib/python3.10/site-packages/executorch-0.2.0a0+1a499e0.dist-info. METADATA and LICENSE both contain the new metadata. imported-using-ghimport Reviewed By: mikekgfb Differential Revision: D56857482 Pulled By: dbort fbshipit-source-id: a8d7b1518ed0fba0172f76394e738b735b51af9f
1 parent b5dd169 commit 4740013

File tree

2 files changed

+77
-1
lines changed

2 files changed

+77
-1
lines changed

README-wheel.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
**ExecuTorch** is a [PyTorch](https://pytorch.org/) platform that provides
2+
infrastructure to run PyTorch programs everywhere from AR/VR wearables to
3+
standard on-device iOS and Android mobile deployments. One of the main goals for
4+
ExecuTorch is to enable wider customization and deployment capabilities of the
5+
PyTorch programs.
6+
7+
The `executorch` pip package is in alpha.
8+
* Supported python versions: 3.10, 3.11
9+
* Compatible systems: Linux x86_64, macOS aarch64
10+
11+
The prebuilt `executorch.extension.pybindings.portable_lib` module included in
12+
this package provides a way to run ExecuTorch `.pte` files, with some
13+
restrictions:
14+
* Only [core ATen
15+
operators](https://pytorch.org/executorch/stable/ir-ops-set-definition.html)
16+
are linked into the prebuilt module
17+
* Only the [XNNPACK backend
18+
delegate](https://pytorch.org/executorch/main/native-delegates-executorch-xnnpack-delegate.html)
19+
is linked into the prebuilt module
20+
21+
Please visit the [ExecuTorch website](https://pytorch.org/executorch/) for
22+
tutorials and documentation. Here are some starting points:
23+
* [Getting
24+
Started](https://pytorch.org/executorch/stable/getting-started-setup.html)
25+
* Set up the ExecuTorch environment and run PyTorch models locally.
26+
* [Working with
27+
local LLMs](https://pytorch.org/executorch/stable/llm/getting-started.html)
28+
* Learn how to use ExecuTorch to export and accelerate a large-language model
29+
from scratch.
30+
* [Exporting to
31+
ExecuTorch](https://pytorch.org/executorch/main/tutorials/export-to-executorch-tutorial.html)
32+
* Learn the fundamentals of exporting a PyTorch `nn.Module` to ExecuTorch, and
33+
optimizing its performance using quantization and hardware delegation.
34+
* Running LLaMA on
35+
[iOS](https://pytorch.org/executorch/stable/llm/llama-demo-ios.html) and
36+
[Android](https://pytorch.org/executorch/stable/llm/llama-demo-android.html)
37+
devices.
38+
* Build and run LLaMA in a demo mobile app, and learn how to integrate models
39+
with your own apps.

pyproject.toml

Lines changed: 38 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,37 @@ dynamic = [
1515
# setup.py will set the version.
1616
'version',
1717
]
18-
# Python dependencies required for development
18+
description = "On-device AI across mobile, embedded and edge for PyTorch"
19+
readme = "README-wheel.md"
20+
authors = [
21+
{name="PyTorch Team", email="[email protected]"},
22+
]
23+
license = {file = "LICENSE"}
24+
keywords = ["pytorch", "machine learning"]
25+
# PyPI package information.
26+
classifiers = [
27+
# How mature is this project? Common values are
28+
# 3 - Alpha
29+
# 4 - Beta
30+
# 5 - Production/Stable
31+
"Development Status :: 3 - Alpha",
32+
"Intended Audience :: Developers",
33+
"Intended Audience :: Education",
34+
"Intended Audience :: Science/Research",
35+
"License :: OSI Approved :: BSD License",
36+
"Topic :: Scientific/Engineering",
37+
"Topic :: Scientific/Engineering :: Mathematics",
38+
"Topic :: Scientific/Engineering :: Artificial Intelligence",
39+
"Topic :: Software Development",
40+
"Topic :: Software Development :: Libraries",
41+
"Topic :: Software Development :: Libraries :: Python Modules",
42+
"Programming Language :: C++",
43+
"Programming Language :: Python :: 3",
44+
# Update this as we support more versions of python.
45+
"Programming Language :: Python :: 3.10",
46+
]
47+
48+
# Python dependencies required for use.
1949
dependencies=[
2050
"expecttest",
2151
"flatbuffers",
@@ -32,6 +62,13 @@ dependencies=[
3262
"tabulate",
3363
]
3464

65+
[project.urls]
66+
# The keys are arbitrary but will be visible on PyPI.
67+
Homepage = "https://pytorch.org/executorch/"
68+
Repository = "https://github.com/pytorch/executorch"
69+
Issues = "https://github.com/pytorch/executorch/issues"
70+
Changelog = "https://github.com/pytorch/executorch/releases"
71+
3572
# Tell setuptools to generate commandline wrappers for tools that we install
3673
# under data/bin in the pip package. This will put these commands on the user's
3774
# path.

0 commit comments

Comments
 (0)