Hi folks – I’ve been fielding numerous questions/confusion over the last few weeks related to torch_mlir.compile
being the API for the project. Most people are (rightly) confused because this is central and called out in all of the docs as the one stop shop. However, it doesn’t give access to the current generation work that is being driven via the fx_importer
. It is also hopelessly tied to the old TorchScript path.
I propose that:
- We rename
torch_mlir/__init__.py
totorch_mlir/torchscript.py
- Create a new
torch_mlir/fx.py
for user level APIs related to importing modules via FX. - Rename the
long_term_roadmap.md
toroadmap.md
and update it to reflect these two paths and that the first is deprecated, while the second isn’t quite ready yet. - Update all project documentation to provide clarity on what each entrypoint provides.
I’d like to avoid the situation in the future where one generation of the technology squats on the whole project namespace so would like to avoid having an __init__.py
at the top level. While we do service end-users, we mostly service integrators, and I would prefer to keep the APIs structured as such.
(edit: fix typo called out by Ramiro in torch_mlir.compile
)