README.md

    Build Status License Version python version support os

    简介

    PaddleHub是飞桨生态的预训练模型应用工具,开发者可以便捷地使用高质量的预训练模型结合Fine-tune API快速完成模型迁移到部署的全流程工作。PaddleHub提供的预训练模型涵盖了图像分类、目标检测、词法分析、语义模型、情感分析、视频分类、图像生成、图像分割、文本审核、关键点检测等主流模型。更多详情可查看官网:https://www.paddlepaddle.org.cn/hub

    特性

    • 模型即软件:通过Python API或命令行实现模型调用,可快速体验或集成飞桨特色预训练模型。-> 效果展示
    • 易用的迁移学习:通过Fine-tune API,内置多种优化策略,只需少量代码即可完成预训练模型的Fine-tuning。-> 效果展示
    • 一键模型转服务:简单一行命令即可搭建属于自己的深度学习模型API服务完成部署。-> 效果展示
    • 自动超参优化:内置AutoDL Finetuner能力,一键启动自动化超参搜索。

    文档教程 [readthedocs]

    效果展示

    1、模型即软件

    PaddleHub采用模型即软件的设计理念,所有的预训练模型与Python软件包类似,具备版本的概念,通过hub install/uninstall 可以便捷完成模型的升级和卸载。还可以通过Python的API或命令行实现快速预测的软件集成,更方便地应用和集成深度学习模型。

    安装PaddleHub后,执行命令hub run,即可快速体验无需代码、一键预测的功能:

    • 使用文字识别轻量级中文OCR模型chinese_ocr_db_crnn_mobile即可一键快速识别图片中的文字。
    $ wget https://paddlehub.bj.bcebos.com/model/image/ocr/test_ocr.jpg
    $ hub run chinese_ocr_db_crnn_mobile --input_path test_ocr.jpg --visualization=True

    预测结果图片保存在当前运行路径下ocr_result文件夹中,如下图所示。

    • 使用目标检测模型pyramidbox_lite_mobile_mask对图片进行口罩检测
    $ wget https://paddlehub.bj.bcebos.com/resources/test_mask_detection.jpg
    $ hub run pyramidbox_lite_mobile_mask --input_path test_mask_detection.jpg

    $ hub run lac --input_text "现在,慕尼黑再保险公司不仅是此类行动的倡议者,更是将其大量气候数据整合进保险产品中,并与公众共享大量天气信息,参与到新能源领域的保障中。"
    [{
        'word': ['现在', ',', '慕尼黑再保险公司', '不仅', '是', '此类', '行动', '的', '倡议者', ',', '更是', '将', '其', '大量', '气候', '数据', '整合', '进', '保险', '产品', '中', ',', '并', '与', '公众', '共享', '大量', '天气', '信息', ',', '参与', '到', '新能源', '领域', '的', '保障', '中', '。'],
        'tag':  ['TIME', 'w', 'ORG', 'c', 'v', 'r', 'n', 'u', 'n', 'w', 'd', 'p', 'r', 'a', 'n', 'n', 'v', 'v', 'n', 'n', 'f', 'w', 'c', 'p', 'n', 'v', 'a', 'n', 'n', 'w', 'v', 'v', 'n', 'n', 'u', 'vn', 'f', 'w']
    }]

    PaddleHub还提供图像分类、语义模型、视频分类、图像生成、图像分割、文本审核、关键点检测等主流模型,更多模型介绍,请前往预训练模型介绍或者PaddleHub官网https://www.paddlepaddle.org.cn/hub 查看

    2、易用的迁移学习

    通过Fine-tune API,只需要少量代码即可完成深度学习模型在自然语言处理和计算机视觉场景下的迁移学习。

    十行代码完成ERNIE工业级文本分类

    • 如需在线快速体验,请点击PaddleHub教程合集,可使用AI Studio平台提供的GPU算力进行快速尝试。

    3、一键模型转服务

    PaddleHub提供便捷的模型转服务的能力,只需简单一行命令即可完成模型的HTTP服务部署。通过以下命令即可快速启动LAC词法分析服务:

    $ hub serving start --modules lac

    更多关于模型服务化使用说明参见PaddleHub模型一键服务化部署

    4、自动超参优化

    PaddleHub内置AutoDL Finetuner能力,提供多种优化策略策略实现自动化超参搜索,使得模型在验证集上得到更好的结果,用户只需要一行命令hub autofinetune即可启动。更多详细使用说明请参见PaddleHub超参优化

    FAQ

    Q: 利用PaddleHub Fine-tune如何适配自定义数据集?

    A: 参考PaddleHub适配自定义数据集完成Fine-tune

    Q: 使用PaddleHub时,无法下载预置数据集、Module的等现象。

    A: 下载数据集、module等,PaddleHub要求机器可以访问外网。可以使用server_check()可以检查本地与远端PaddleHub-Server的连接状态,使用方法如下:

    import paddlehub
    paddlehub.server_check()
    # 如果可以连接远端PaddleHub-Server,则显示Request Hub-Server successfully。
    # 如果无法连接远端PaddleHub-Server,则显示Request Hub-Server unsuccessfully。

    Q: 利用PaddleHub ERNIE/BERT进行Fine-tune时,运行出错并提示paddle.fluid.core_avx.EnforceNotMet: Input ShapeTensor cannot be found in Op reshape2等信息。

    A: 预训练模型版本与PaddlePaddle版本不匹配。可尝试将PaddlePaddle和PaddleHub升级至最新版本,并将原ERNIE模型卸载。

    $ pip install --upgrade paddlehub
    $ hub uninstall ernie

    More

    当您安装或者使用遇到问题时,如果在FAQ中没有找到解决方案,欢迎您将问题以Github Issues的形式提交给我们,我们会第一时间进行跟进。

    微信扫描二维码,欢迎加入PaddleHub技术交流群

    如扫码失败,请添加微信15711058002,并备注“Hub”,运营同学会邀请您入群。

    许可证书

    本项目的发布受Apache 2.0 license许可认证。

    致谢

    我们非常欢迎您为PaddleHub贡献代码,也十分感谢您的反馈。

    • 非常感谢Austendeng贡献了修复SequenceLabelReader的pr
    • 非常感谢cclauss贡献了优化travis-ci检查的pr
    • 非常感谢奇想天外贡献了口罩检测的demo
    • 非常感谢mhlwsk贡献了修复序列标注预测demo的pr
    • 非常感谢zbp-xxxp贡献了看图作诗的module
    • 非常感谢zbp-xxxp七年期限联合贡献了看图写诗中秋特别版module
    • 非常感谢livingbody贡献了基于PaddleHub能力的风格迁移和中秋看图写诗微信小程序

    项目简介

    Awesome pre-trained models toolkit based on PaddlePaddle. (400+ models including Image, Text, Audio, Video and Cross-Modal with Easy Inference & Serving)

    🚀 Github 镜像仓库 🚀

    源项目地址

    https://github.com/PaddlePaddle/PaddleHub

    发行版本 29

    PaddleHub v2.3.1

    全部发行版

    贡献者 36

    全部贡献者

    开发语言

    • Python 99.8 %
    • HTML 0.2 %
    • Shell 0.0 %