mindspore_hub
=========================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/master/resource/_static/logo_source.svg
    :target: https://gitee.com/mindspore/hub/blob/master/docs/api_python/hub.rst
    :alt: 查看源文件


MindSpore Hub是MindSpore生态系统的预训练模型应用工具，作为模型开发者和应用开发者的通道。

.. py:function:: mindspore_hub.load(name, *args, source='gitee', pretrained=True, force_reload=False, **kwargs)

    用于加载指定网络。加载完成后，可用于推理验证、迁移学习等。如果 `source` 为 ``'local'``，会先检查本地是否存在对应模型文件，如果存在
    就加载本地的，反之会自动下载模型文件并加载；如果 `pretrained` 为 ``True``,会先检查本地是否存在对应的ckpt文件，存在就会直接加载，
    不存在就会自动下载到本地并加载。

    参数：
        - **name** (str) - 网络的 ``'uid'`` 或 ``'url'`` ，或者md文件的本地路径。
        - **args** (tuple) - 网络初始化的参数。
        - **source** (str，可选) - 是否将 `name` 解析为gitee模型URI、github模型URI或本地资源。默认值：``'gitee'``。
        - **pretrained** (bool，可选) - 是否加载预训练模型。 默认值：``True``。
        - **force_reload** (bool，可选) - 是否从 `url` 重新加载网络和ckpt。 默认值：``False``。
        - **kwargs** (dict) - 网络初始化的关键字参数。

    返回：
        Cell，网络。

.. py:function:: mindspore_hub.hub_list(version=None, force_reload=False)

    列出MindSpore Hub支持的所有asset。

    参数：
        - **version** (str) - 指定要列出的版本。``None`` 表示最新版本。默认值：``None``。
        - **force_reload** (bool) - 是否从 `url` 重新加载网络。 默认值：``False``。

    返回：
        list，MindSpore Hub支持的asset列表。