{ "info": { "author": "Paperspace Co.", "author_email": "info@paperspace.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Software Development :: Libraries" ], "description": "# Gradient ML SDK\n\nThis is an SDK for performing Machine Learning with Gradient\u00ba, it can be installed in addition to [gradient-cli](https://github.com/Paperspace/gradient-cli).\n\n# Requirements\n\nThis SDK requires Python 3.5+.\n\nTo install it, run:\n\n```bash\npip install gradient-sdk\n```\n\n# Usage\n\n## Multinode Helper Functions\n\n### Multinode GRPC Tensorflow\n\n**Set the TF_CONFIG environment variable**\nFor multi-worker training, you need to set the `TF_CONFIG` environment variable for each binary running in your cluster. Set the value of `TF_CONFIG` to a JSON string that specifies each task within the cluster, including each task's address and role within the cluster. We've provided a Kubernetes template in the tensorflow/ecosystem repo which sets `TF_CONFIG` for your training tasks.\n\n**get_tf_config()**\n\nFunction to set value of `TF_CONFIG` when run on machines within Paperspace infrastructure.\n\nIt can raise a `ConfigError` exception with message if there's a problem with its configuration in a particular machine.\n\n**_Usage example:_**\n\n```python\nfrom gradient_sdk import get_tf_config\n\nget_tf_config()\n```\n\n## Hyperparameter Tuning\n\nCurrently, Gradient\u00ba only supports _Hyperopt_ for Hyperparameter Tuning.\n\n**hyper_tune()**\n\nFunction to run hyperparameter tuning.\n\nIt accepts the following arguments:\n\n- `train_model`\n User model to tune.\n- `hparam_def`\n User definition (scope) of search space.\n To set this value, refer to [hyperopt documentation](https://github.com/hyperopt/hyperopt).\n- `algo`\n Search algorithm.\n _Default_: `tpe.suggest` (from hyperopt).\n- `max_ecals`\n Maximum number of function evaluations to allow before returning.\n _Default_: `25`.\n- `func`\n Function to be run by hyper tune.\n _Default_: `fmin` (from hyperopt). _Do not change this value if you do not know what you are doing!_\n\nIt returns a dict with information about the tuning process.\n\nIt can raise a `ConfigError` exception with message if there's no connection to MongoDB.\n\n**Note:** _You do not need to worry about setting your MongoDB version; it will be set within Paperspace infrastructure for hyperparameter tuning._\n\n**Usage example:**\n\n```python\nfrom gradient_sdk import hyper_tune\n\n# Prepare model and search scope\n\n# minimal version\nargmin1 = hyper_tune(model, scope)\n\n# pass more arguments\nargmin2 = hyper_tune(model, scope, algo=tpe.suggest, max_evals=100)\n```\n\n## Utility Functions\n\n**get_mongo_conn_str()**\n\nFunction to check and construct MongoDB connection string.\n\nIt returns a connection string to MongoDB.\n\nIt can raise a `ConfigError` exception with message if there's a problem with any values used to prepare the MongoDB connection string.\n\nUsage example:\n\n```python\nfrom gradient_sdk import get_mongo_conn_str\n\nconn_str = get_mongo_conn_str()\n```\n\n**data_dir()**\n\nFunction to retrieve path to job space.\n\nUsage example:\n\n```python\nfrom gradient_sdk import data_dir\n\njob_space = data_dir()\n```\n\n**model_dir()**\n\nFunction to retrieve path to model space.\n\nUsage example:\n\n```python\nfrom gradient_sdk import model_dir\n\nmodel_path = model_dir(model_name)\n```\n\n**export_dir()**\n\nFunction to retrieve path for model export.\n\nUsage example:\n\n```python\nfrom gradient_sdk import export_dir\n\nmodel_path = export_dir(model_name)\n```\n\n**worker_hosts()**\n\nFunction to retrieve information about worker hosts.\n\nUsage example:\n\n```python\nfrom gradient_sdk import worker_hosts\n\nmodel_path = worker_hosts()\n```\n\n**ps_hosts()**\n\nFunction to retrieve information about Paperspace hosts.\n\nUsage example:\n\n```python\nfrom gradient_sdk import ps_hosts\n\nmodel_path = ps_hosts()\n```\n\n**task_index()**\n\nFunction to retrieve information about task index.\n\nUsage example:\n\n```python\nfrom gradient_sdk import task_index\n\nmodel_path = task_index()\n```\n\n**job_name()**\n\nFunction to retrieve information about job name.\n\nUsage example:\n\n```python\nfrom gradient_sdk import job_name\n\nmodel_path = job_name()\n```\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Paperspace/gradient-sdk", "keywords": "gradient sdk ml", "license": "", "maintainer": "", "maintainer_email": "", "name": "gradient-sdk", "package_url": "https://pypi.org/project/gradient-sdk/", "platform": "", "project_url": "https://pypi.org/project/gradient-sdk/", "project_urls": { "Homepage": "https://github.com/Paperspace/gradient-sdk" }, "release_url": "https://pypi.org/project/gradient-sdk/0.0.4/", "requires_dist": [ "wheel", "hyperopt (<0.2)", "pymongo", "tox ; extra == 'dev'" ], "requires_python": "", "summary": "Gradient ML SDK", "version": "0.0.4", "yanked": false, "yanked_reason": null }, "last_serial": 6018348, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "836499d5b1be5b9c6b801487d867388c", "sha256": "e0c3ce1e754c95cf30ef71f1387b708dfdbf2924028248cae5275493b8ea06f5" }, "downloads": -1, "filename": "gradient_sdk-0.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "836499d5b1be5b9c6b801487d867388c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6667, "upload_time": "2019-04-25T05:09:09", "upload_time_iso_8601": "2019-04-25T05:09:09.198261Z", "url": "https://files.pythonhosted.org/packages/d9/b4/e2bb2d1cec56925633f67a2904317dfd8bdee3e7d6b1df8ef70e37883285/gradient_sdk-0.0.1-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "25b2e6449d125d11b095e610066c3407", "sha256": "6ce0fbfd0734e790a04dea258e1c85873e70d6fe3c4e4bed1a83984724e626c0" }, "downloads": -1, "filename": "gradient_sdk-0.0.1.tar.gz", "has_sig": false, "md5_digest": "25b2e6449d125d11b095e610066c3407", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4857, "upload_time": "2019-04-25T05:09:11", "upload_time_iso_8601": "2019-04-25T05:09:11.641726Z", "url": "https://files.pythonhosted.org/packages/28/db/5912547640d7d45ec295c99e490dad22b7af688aed851795e288a4ec2486/gradient_sdk-0.0.1.tar.gz", "yanked": false, "yanked_reason": null } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "08a1b89499f1db7ea19d7a0ab2caf9fd", "sha256": "ef48d67e3ea1a89f135612dee056f35c5552cb008a48b286a9bc1d8628b1150c" }, "downloads": -1, "filename": "gradient_sdk-0.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "08a1b89499f1db7ea19d7a0ab2caf9fd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6664, "upload_time": "2019-04-26T11:25:49", "upload_time_iso_8601": "2019-04-26T11:25:49.131948Z", "url": "https://files.pythonhosted.org/packages/e8/1f/d1a4ad8ed1d62dd336367ee0bd2855516f50ea4dc34567be9877e30b9bff/gradient_sdk-0.0.2-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "557ea158d5dd00ade39405648685d4a8", "sha256": "b57a68ccfd1fc6498b0dd3bfe29fdc5fd1c0531ba291dc74b179accab72854bd" }, "downloads": -1, "filename": "gradient_sdk-0.0.2.tar.gz", "has_sig": false, "md5_digest": "557ea158d5dd00ade39405648685d4a8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4819, "upload_time": "2019-04-26T11:25:50", "upload_time_iso_8601": "2019-04-26T11:25:50.385590Z", "url": "https://files.pythonhosted.org/packages/3a/48/c64ced9f6af72589221e30612ee213c66acaf11bf866778751970dcb8569/gradient_sdk-0.0.2.tar.gz", "yanked": false, "yanked_reason": null } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "58daf224625699b0018e90297781edbc", "sha256": "9c570e9681d84597cc3134e4357c2c3fa40d48ad9abef494f5e1c763ba398904" }, "downloads": -1, "filename": "gradient_sdk-0.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "58daf224625699b0018e90297781edbc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6943, "upload_time": "2019-06-26T13:53:12", "upload_time_iso_8601": "2019-06-26T13:53:12.837646Z", "url": "https://files.pythonhosted.org/packages/d2/9a/7e754bc5ca3595f31fc544b3c24c94c30e118adebfa392141e2e444d6ddd/gradient_sdk-0.0.3-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "ad3af2e174923e2ae96770a16b890a17", "sha256": "da01d5db6ad5f446ac502126f3a304c76aaaf43707bfbcb3ec4d6a5f3f11726e" }, "downloads": -1, "filename": "gradient_sdk-0.0.3.tar.gz", "has_sig": false, "md5_digest": "ad3af2e174923e2ae96770a16b890a17", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5156, "upload_time": "2019-06-26T13:53:14", "upload_time_iso_8601": "2019-06-26T13:53:14.285576Z", "url": "https://files.pythonhosted.org/packages/a2/ed/8916d45452a1ea2c05bb89dab476ceb1f7304cd944cf385cb5b642c47300/gradient_sdk-0.0.3.tar.gz", "yanked": false, "yanked_reason": null } ], "0.0.4": [ { "comment_text": "", "digests": { "md5": "638802ffb1ff9404bfac5e617ab07ce0", "sha256": "1e8a3615a2203f7cec259626c48a7e66ee15a63d3f6a011f8c9aa56707b50155" }, "downloads": -1, "filename": "gradient_sdk-0.0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "638802ffb1ff9404bfac5e617ab07ce0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6933, "upload_time": "2019-10-23T12:35:59", "upload_time_iso_8601": "2019-10-23T12:35:59.293898Z", "url": "https://files.pythonhosted.org/packages/4c/bc/243071f8e2abc9ab6b16d2a93ec64a91b2619c2ee83f83a42634431613d1/gradient_sdk-0.0.4-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "0f1699737fc8c35fc2ca4f0bdc4f18c4", "sha256": "43da1e6238e025fda58715b5ca9b3079000fa4c825996f4fc60cccb204ea2646" }, "downloads": -1, "filename": "gradient_sdk-0.0.4.tar.gz", "has_sig": false, "md5_digest": "0f1699737fc8c35fc2ca4f0bdc4f18c4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5160, "upload_time": "2019-10-23T12:36:00", "upload_time_iso_8601": "2019-10-23T12:36:00.914867Z", "url": "https://files.pythonhosted.org/packages/bc/ee/60ad1cfe8470769f7399fc1dca592ce66ecb3675c7593b117d7f3f1d72b4/gradient_sdk-0.0.4.tar.gz", "yanked": false, "yanked_reason": null } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "638802ffb1ff9404bfac5e617ab07ce0", "sha256": "1e8a3615a2203f7cec259626c48a7e66ee15a63d3f6a011f8c9aa56707b50155" }, "downloads": -1, "filename": "gradient_sdk-0.0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "638802ffb1ff9404bfac5e617ab07ce0", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6933, "upload_time": "2019-10-23T12:35:59", "upload_time_iso_8601": "2019-10-23T12:35:59.293898Z", "url": "https://files.pythonhosted.org/packages/4c/bc/243071f8e2abc9ab6b16d2a93ec64a91b2619c2ee83f83a42634431613d1/gradient_sdk-0.0.4-py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "0f1699737fc8c35fc2ca4f0bdc4f18c4", "sha256": "43da1e6238e025fda58715b5ca9b3079000fa4c825996f4fc60cccb204ea2646" }, "downloads": -1, "filename": "gradient_sdk-0.0.4.tar.gz", "has_sig": false, "md5_digest": "0f1699737fc8c35fc2ca4f0bdc4f18c4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5160, "upload_time": "2019-10-23T12:36:00", "upload_time_iso_8601": "2019-10-23T12:36:00.914867Z", "url": "https://files.pythonhosted.org/packages/bc/ee/60ad1cfe8470769f7399fc1dca592ce66ecb3675c7593b117d7f3f1d72b4/gradient_sdk-0.0.4.tar.gz", "yanked": false, "yanked_reason": null } ], "vulnerabilities": [] }