中文
本页内容

FAQ ​

本章节整理了Modelres平台使用过程中遇到的常见问题，希望能够解答您使用过程中的疑惑。若遇到常见问题中不存在的，欢迎在微信群或者feedback通过issue进行反馈。

Modelers常见问题 ​

Q1：单击他人分享的在线文档链接进入Modelers时，提示服务器错误500怎么解决？ ​

复制分享的网址链接，通过浏览器重新打开。

Q2：当创建者将模型、数据集或体验空间设置为私有后，为什么公共平台还能看到相关内容？ ​

设置为私有的模型、数据集和体验空间仅支持创建者或组织内成员可见。展示在公共平台，只是便于创建者或组织内成员查看，对其他用户不会展示该内容。

Q3: 模型文件上传后部分文件一直显示“审核中”应该怎么处理？ ​

该状态若长时间未改变，可依次尝试以下几种方式进行处理：

  1. 删除该仓库下的相关文件重新上传。
  2. 删除该仓库，重新创建仓库并上传模型文件。
  3. 如果经过以上操作问题依然未解决，请联系我们的技术支持。

Q4：上传模型文件过程中无任何报错，但上传后文件大小被严重压缩是什么原因？ ​

请确认是否通过某类服务器上传，建议更换为本地文件上传。

Q5：上传模型或数据集时，提示“The size of each file should be within 100MB”时怎么处理？ ​

默认设置了常见的大文件类型，该提示可能是因为上传的大文件为非默认的常见类型，需要使用git lfs track指令手动添加。

使用track命令跟踪的文件，可以是文件类型或者具体的文件名，请根据实际需要选择。例如：git lfs track "*.bin"或者git lfs track "big file.bin"。

Q6：打开模型或数据集的“README”文件进行编辑后无法提交保存是什么原因？ ​

  • 未设置License，若没有需要设置的License，可以设置License为unknown。
  • License来源不合规，需提供官方License。

Q7：上传模型或数据集时，提示错误原因为：License不是列举类型中的一种，应该怎么处理？ ​

  • 检查本地“README”文件中是否存在License name，若不存在，需添加License：xxx。
  • 确保创建时所选的License类型和本地README文件中的License name一致。

Q8：当使用git clone或push时报403，是什么原因？ ​

因为魔乐社区的网站和服务只能在中国境内包含港澳台使用，若是海外设备访问则报403。可以在浏览器中访问https://ipinfo.info或者执行curl ipinfo.io命令查看当前访问设备的地理位置。

Q9：当文件超过5GB，上传不了应该怎么办？ ​

超过5GB的文件需要使用multipart上传，目前只能使用工具链。

Q10：提交文件只能一个一个提交，不能按照文件夹整个提交吗？ ​

使有upload_folder这个函数，git push可以整个文件夹提交。

Q11：魔乐社区的页面支持上传文件吗？ ​

魔乐社区的页面暂不支持文件上传。

Q12：怎么上传自己的模型？ ​

具体模型的上传操作，请参考上传模型。

Q13：上传模型到模型库时，使用的登录账号是魔乐社区的账号密码吗？ ​

上传模型到模型库时，使用的账号密码不是社区的账号密码。注册魔乐社区用户后需要创建Token，以便后续的交互操作。详情请参考模型贡献章节。

Q14：使用openMind Hub上传大文件时，遇到报错误500是什么原因？ ​

可能存在以下原因：

  • 未设置License，若没有需要设置的License，可以设置License为unknown。
  • License来源不合规，需提供官方License。

若不是以上的原因导致或仍然报错，欢迎到feedback仓库通过issue反馈。

Q15：使用upload_file上传文件，缺失path_in_repo参数，导致上传失败时应该怎么处理？ ​

需补充path_in_repo参数，即文件上传到仓库内的路径，该参数为必填项。

Q16：git push了一份数据集，那如何在notebook里调用呢？ ​

  1. 需将数据集push到魔乐的数据集模块。
  2. 使用openMind hub工具链下载。

Q17：文件已经上传并且在页面也有显示，但下载时失败，是什么原因？ ​

文件没有上传成功，需要重新上传文件。

Q18：加入组织后，自己创建的模型怎么添加到组织下？ ​

在“个人中心”页面，进入“我的组织”，在目标组织下，单击“创建 > 创建模型”，在已创建的模型中上传具体内容。

Q19：创建模型时候出现超出计数，是什么问题？ ​

目前个人用户最多只可以创建50个模型。

Q20：基于README.md修改标签时，提示服务器错误，是什么原因？ ​

在README.md重复添加License关键词会出现报错（如图）。建议在README.md的头部添加一次即可。

readme

Q21：在模型可用性测试中，日志提示“requirements.txt NOT FOUND, skip dependency installation[ERROR] inference.py NOT FOUND”，且使用inference.py的引用是正确的，是什么原因？ ​

这是由于inference.py的位置放错引起的。

requirements.txt和inference.py必须位于examples文件下：

  • examples文件夹路径：位于根目录下
  • requirements.txt路径：examples/requirements.txt
  • inference.py路径：examples/inference.py

Q22：有没有部署的demo可以参考？ ​

社区里存在可以运行的demo，详情请参考体验空间。

Q23：如何更好的分享自己的空间？ ​

可以通过补充录制视频或分享文章等多种形式，并将相关链接放在README.md文件、讨论区等分享自己的空间，让其他人更容易理解使用您的作品。可以参考社区开发者@munger1985的作品，感谢开发者的支持和贡献。

体验空间常见问题 ​

Q1：当体验空间的状态为“排队中”或“构建中”等中间状态时，应该怎么办？ ​

当体验空间的状态为“排队中”或“构建中”等中间状态时，请参考以下操作进行处理：

  1. 了解当前状态：排队中，表示系统正在处理其他用户的请求，您的请求已被记录并在队列中等待执行。需耐心等待，一旦资源可用，构建将会自动启动。
  2. 查看构建日志：构建开始后，利用平台的构建日志功能密切关注进程与任何潜在错误。这是诊断构建状态最直接的途径。
  3. 代码审查与优化：若构建因错误终止，请复查代码是否有基础错误、缺失依赖或兼容性问题。参考最佳实践，能有效预防此类问题。
  4. 资源限制与应对策略：将尽力为所有用户提供充足资源，但偶尔的资源紧张可能导致排队或构建缓慢。
  5. 留意状态更新：定期进行系统维护与资源调整，以保障服务的稳定性和效率，排队问题将会在此期间逐一解决。
  6. 联系技术支持：若构建长时间未启动（超出预计等待时间），或反复构建失败且排查无果，请联系我们的技术支持。

Q2：当服务启动后显示503、403和502错误页时，应该怎么办？ ​

当启动服务后遇到503、403或502错误页面时，请参考以下操作进行处理：

  1. 了解错误类型：

    • 503 Service Unavailable：服务暂时不可用，一般是编写的体验空间的应用代码有问题，请通过查看日志或其他方式排查代码问题。
    • 403 Forbidden：一般是通过非法方式访问了体验空间，请确保已正确登录魔乐社区网站。
    • 502 Bad Gateway：一般是代码中编写了大模型下载和载入的动作，应用阻塞在模型下载过程，请查看日志获取最新服务启动进展。

  2. 查看运行日志：查看服务运行日志，详细检查日志中的错误信息，找出导致错误的具体原因。

  3. 本地调试代码：在本地环境中运行代码，检查是否能正常运行。确保所有依赖和配置项在本地环境中都能正确运行。如果本地运行正常，可能是部署环境的问题。

  4. 重启容器：在平台上重启服务容器。重启操作可以解决一些暂时性的启动问题，并重新分配资源。

  5. 联系技术支持：如果经过以上操作问题依然未解决，请联系我们的技术支持。

Q3：在体验空间页面，没有显示离线体验按钮怎么处理？ ​

在使用平台时，若发现无法看到“离线体验”按钮，通常是由于后台服务尚未完全就绪或配置存在缺漏。请执行以下操作，以便快速恢复功能：

  1. 确认容器状态：确认容器是否已经成功启动过。如果容器没有启动，那么离线体验的相关功能将无法正常显示。
  2. 确认体验空间设置：只有公开的体验空间才支持离线体验，如果您的体验空间是私有的，请先设置为公开。
  3. 重启容器：如果以上步骤确认无误，可以尝试重新启动容器。这一操作可以解决后台服务未能正确启动的问题。
  4. 联系技术支持：如果经过以上操作问题依然未解决，请联系我们的技术支持。

Q4：查询不到空间日志怎么处理？ ​

当遇到空间日志无法查询的情况，请参考以下操作进行处理：

  1. 了解问题原因：空间日志显示"No logs"，通常是因为用户访问日志接口时无法获取日志。可能是由于接口所属的服务没有正常运行、正在进行版本更新或者用户的运行空间容器没有正常启动。
  2. 刷新日志：通过多次单击日志刷新按钮，尝试重新获取日志。系统有时可能会因为临时问题导致日志显示异常，刷新操作可以帮助解决此类问题。
  3. 等待一段时间：可以过一段时间查看日志是否恢复正常。平台可能正在进行维护或资源分配调整，导致日志暂时无法显示。
  4. 重启容器：如果多次刷新日志无效，可以尝试重启容器。容器重启后，可能会恢复正常运行，从而能够正确显示日志。
  5. 联系技术支持：如果经过以上操作问题依然未解决，请联系我们的技术支持。

Q5：体验空间是否有存储大小的限制？ ​

体验空间分为NPU空间和CPU空间，其中NPU空间最多提供100GB的存储容量，而CPU空间则提供约20GB的存储容量。

Q6：如果体验空间在构建过程中，下载模型时报“connection break”，怎么重新触发构建？ ​

在目标体验空间的“设置”页面，单击“重启空间”即可重新触发构建。

Q7：请问怎么更换体验空间的封面图？ ​

选择目标体验空间，在“设置”界面，将鼠标移动到原图片上，按提示删除后再重新上传新的图片。