Paperspace巨蟒
gradient的Python项目详细描述
渐变cli
版本0.2.3
有关当前版本和发行历史的详细信息,请参见releaseNotes.md。
入门
一定要建立一个文件空间帐户。转到http://paperspace.com 注册。
使用pip、pipenv或conda安装渐变包,例如:
pip安装-u渐变
要安装/更新Gradient的预发布(alpha/beta)版本,请使用:
pip install-u—预渐变
启用自动完成功能:
在
.bashrc
(或.zshrc
)中添加以下内容,以便在激活shell时启用自动完成功能。 如果Gradient安装在虚拟环境中,则必须在激活
脚本中添加以下内容:
eval"$(_gradient_complete=source gradient)"
或者,您可以通过以下方式创建激活脚本:
(_gradient_complete=源渐变)>;~/paperspace_complete.sh
然后添加
。~/paperspace_complete.sh
到您的.bashrc
,.zshrc
或激活
脚本。更多信息:https://click.palletsprojects.com/en/7.x/bashcomplete/" rel="nofollow">https://click.palletsprojects.com/en/7.x/bashcomplete/
通过执行以下操作设置API密钥:
渐变式api key<;此处是您的api键>;
注意:您的api密钥缓存在~/.paperspace/config.json中
您可以通过执行以下操作来删除缓存的api密钥:
渐变注销
使用gradient远程运行python脚本:
渐变运行myscript.py--name<;新作业名称>;
脚本将在Paperspace作业群集节点上运行,其输出将在本地记录。 注意:如果未提供工作区,则此操作会将您当前的整个工作目录存档并上载到我们的服务器
< > >远程运行python脚本:
渐变运行<;python_script.py>;[参数]
示例:
渐变运行myscript.py a b c
使用e
-m
选项:渐变运行-m<;module_path>;[参数]
示例:
渐变运行-m pip--版本
使用
-c
选项远程运行python命令:渐变运行-c"python_statement;…"
示例:
渐变运行-c"import os;print(os.getcwd())"
使用
--command
选项远程运行可执行命令或shell命令:渐变运行<;path_to_script.py>;--command"<;可执行或外壳命令>;"
示例:
渐变运行<;path_to_script.py>;--命令"ls-al"
< > >在python代码中设置package paperspace.config选项:
gradient.config.paperspace_api_key='1qks1hkssu7e1k…'
设置paperspace_api_key环境变量:
(在Linux/Mac上:)
导出Paperspace\u API\u key=1qks1hkssu7e1k…
(在Windows上:)
设置Paperspace_API_key=1qks1hkssu7e1k…
注意:以上方法优先于在
~/.paperspace/config.json
通过运行:
渐变APIKEY 1QKS1HKSU7E1K…
< > >
创建/创建并开始实验
要创建新的实验,请使用:
gradient experiments create [type] [--options]
两种可用的实验类型是singlenode
和multinode
要创建并立即开始新的实验,请使用:
gradient experiments run [type] [--options]
有关可用命令的完整列表,请运行渐变实验--help
。
请注意,创建新实验需要一些选项。
按名称运行python脚本
可以从命令行在Paperspace服务器上运行python脚本,如下所示:
gradient run myscript.py --name my_new_job
您还可以在命令行上提供其他作业选项:
gradient run myscript.py --name my_new_job --projectId myproject --machineType P5000 \
--container paperspace/tensorflow-python`
注意:此功能已弃用,以后的版本中将不再提供
有关可以指定的作业创建选项的完整列表,请参见渐变文档。
基本运行方案
运行选项
<;script>;
选项是python脚本或python模块的路径。如果脚本或模块存在于本地文件系统中,则将上载该脚本或模块。
其他脚本args
可以在python脚本或模块路径之后提供。您可以使用-
选项禁止将脚本参数列表解释为渐变运行
选项。
-m<;module path>;
选项将指定的库模块作为脚本运行。这相当于python
可执行文件的-m
选项。在-m
选项之后,将禁用进一步的Paperspace Run选项处理。
-c"python_statement;…"
选项运行指定的python语句。这相当于python
可执行文件的-c
选项。在-c
选项之后,将禁用进一步的Paperspace Run选项处理。
-
选项禁用进一步的运行命令选项处理,并将其余参数传递给指定的脚本。这允许您向脚本传递参数,否则可能与运行命令选项或作业创建选项冲突。
--command"shell cmd"
选项用于在容器中运行任意可执行文件或shell命令。注意:可执行命令或shell命令必须已经在容器映像中可用,或者使用--workspace
选项复制过来。
工作选项
--workspace
选项允许您指定要上载的工作区文件或目录,或指定要下载并与容器合并的git repo链接。例如,要上载当前目录和脚本文件,请运行:
gradient run myscript.py --name my_new_job --workspace workspace-dir
注意:--工作区
默认为
有关--workspace
选项和相关选项的更多详细信息,请参阅PaperSpae API作业创建文档。
--ignore files<;file or dir>;,…"
选项可用于指定工作区上载要忽略的文件和目录的简单逗号分隔列表:
gradient run myscript.py --name my_new_job --workspace . --ignoreFiles "hello.py,paperspace"
默认情况下会忽略以下文件和目录:.git
,.gitignore
,.pycache
可以指定其他作业创建选项,例如--machine type<;machine type>;
,--container<;container image reference>;
,以及--projectd<;project name>;
。
有关这些选项的完整说明,请参见paperspae api作业创建文档。
默认容器
如果在使用docker hub上的paperspace run<;script.py>;
或paperspace.run()
函数时指定了nocontainer
选项,则使用的默认容器图像是paperspace/tensorflow python
。这个容器为python2和python3安装了tensorflow gpu库,以及其他一些流行的包,包括numpy、scipy、scikit learn、pandas、枕头和matp洛利布。
它基于google docker imagegcr.io/tensorflow/tensorflow:1.5.0-gpu
并添加了对python3、pip3和pipenv的支持。
其他示例
有关其他示例,请参见测试
文件夹中的脚本。
验证选项
贡献
想做贡献吗?请通过以下网址与我们联系:hello@paperspace.com