hydra-core


Namehydra-core JSON
Version 1.3.2 PyPI version JSON
download
home_pagehttps://github.com/facebookresearch/hydra
SummaryA framework for elegantly configuring complex applications
upload_time2023-02-23 18:33:43
maintainer
docs_urlNone
authorOmry Yadan
requires_python
licenseMIT
keywords command-line configuration yaml tab-completion
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            <p align="center"><img src="https://raw.githubusercontent.com/facebookresearch/hydra/master/website/static/img/Hydra-Readme-logo2.svg" alt="logo" width="70%" /></p>

<p align="center">
  <a href="https://pypi.org/project/hydra-core/">
    <img src="https://img.shields.io/pypi/v/hydra-core" alt="PyPI" />
  </a>
  <a href="https://circleci.com/gh/facebookresearch/hydra">
    <img src="https://img.shields.io/circleci/build/github/facebookresearch/hydra?token=af199cd2deca9e70e53776f9ded96284b10687e9" alt="CircleCI" />
  </a>
  <a href="#">
    <img src="https://img.shields.io/pypi/l/hydra-core" alt="PyPI - License" />
  </a>
  <a href="#">
    <img src="https://img.shields.io/pypi/pyversions/hydra-core" alt="PyPI - Python Version" />
  </a>
  <a href="https://pepy.tech/project/hydra-core?versions=0.11.*&versions=1.0.*&versions=1.1.*">
    <img src="https://pepy.tech/badge/hydra-core/month" alt="Downloads" />
  </a>
  <a href="https://github.com/psf/black">
    <img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code style: black" />
  </a>
  <a href="https://lgtm.com/projects/g/facebookresearch/hydra/alerts/">
    <img src="https://img.shields.io/lgtm/alerts/g/facebookresearch/hydra.svg?logo=lgtm&logoWidth=18" alt="Total alerts" />
  </a>
  <a href="https://lgtm.com/projects/g/facebookresearch/hydra/context:python">
    <img src="https://img.shields.io/lgtm/grade/python/g/facebookresearch/hydra.svg?logo=lgtm&logoWidth=18" alt="Language grade: Python" />
  </a>
  <p align="center">
    <i>A framework for elegantly configuring complex applications.</i>
  </p>
  <p align="center">
    <i>Check the <a href="https://hydra.cc/">website</a> for more information,<br>
    or click the thumbnail below for a one-minute video introduction to Hydra.</i>
  </p>
  <p align="center">
   <a href="http://www.youtube.com/watch?feature=player_embedded&v=Slc3gRQpnBI" target="_blank">
     <img src="http://img.youtube.com/vi/Slc3gRQpnBI/hqdefault.jpg" alt="1 minute overview" width="240" height="180" border="10" />
   </a>
  </p>
</p>

----------------------


### Releases

#### Stable

**Hydra 1.3** is the stable version of Hydra.
- [Documentation](https://hydra.cc/docs/1.3/intro/)
- Installation : `pip install hydra-core --upgrade`

See the [NEWS.md](NEWS.md) file for a summary of recent changes to Hydra.

### License
Hydra is licensed under [MIT License](LICENSE).

## Hydra Ecosystem

#### Check out these third-party libraries that build on Hydra's functionality:
* [hydra-zen](https://github.com/mit-ll-responsible-ai/hydra-zen): Pythonic utilities for working with Hydra. Dynamic config generation capabilities, enhanced config store features, a Python API for launching Hydra jobs, and more.
* [lightning-hydra-template](https://github.com/ashleve/lightning-hydra-template): user-friendly template combining Hydra with [Pytorch-Lightning](https://github.com/Lightning-AI/lightning) for ML experimentation.
* [hydra-torch](https://github.com/pytorch/hydra-torch): [configen](https://github.com/facebookresearch/hydra/tree/main/tools/configen)-generated configuration classes enabling type-safe PyTorch configuration for Hydra apps.
* NVIDIA's DeepLearningExamples repository contains a Hydra Launcher plugin, the [distributed_launcher](https://github.com/NVIDIA/DeepLearningExamples/tree/9c34e35c218514b8607d7cf381d8a982a01175e9/Tools/PyTorch/TimeSeriesPredictionPlatform/distributed_launcher), which makes use of the pytorch [distributed.launch](https://pytorch.org/docs/stable/distributed.html#launch-utility) API.

#### Ask questions in Github Discussions or StackOverflow (Use the tag #fb-hydra or #omegaconf):
* [Github Discussions](https://github.com/facebookresearch/hydra/discussions)
* [StackOverflow](https://stackexchange.com/filters/391828/hydra-questions)
* [Twitter](https://twitter.com/Hydra_Framework)

Check out the Meta AI [blog post](https://ai.facebook.com/blog/reengineering-facebook-ais-deep-learning-platforms-for-interoperability/) to learn about how Hydra fits into Meta's efforts to reengineer deep learning platforms for interoperability.

### Citing Hydra
If you use Hydra in your research please use the following BibTeX entry:
```BibTeX
@Misc{Yadan2019Hydra,
  author =       {Omry Yadan},
  title =        {Hydra - A framework for elegantly configuring complex applications},
  howpublished = {Github},
  year =         {2019},
  url =          {https://github.com/facebookresearch/hydra}
}
```


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/facebookresearch/hydra",
    "name": "hydra-core",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "command-line configuration yaml tab-completion",
    "author": "Omry Yadan",
    "author_email": "omry@fb.com",
    "download_url": "https://files.pythonhosted.org/packages/6d/8e/07e42bc434a847154083b315779b0a81d567154504624e181caf2c71cd98/hydra-core-1.3.2.tar.gz",
    "platform": null,
    "description": "<p align=\"center\"><img src=\"https://raw.githubusercontent.com/facebookresearch/hydra/master/website/static/img/Hydra-Readme-logo2.svg\" alt=\"logo\" width=\"70%\" /></p>\n\n<p align=\"center\">\n  <a href=\"https://pypi.org/project/hydra-core/\">\n    <img src=\"https://img.shields.io/pypi/v/hydra-core\" alt=\"PyPI\" />\n  </a>\n  <a href=\"https://circleci.com/gh/facebookresearch/hydra\">\n    <img src=\"https://img.shields.io/circleci/build/github/facebookresearch/hydra?token=af199cd2deca9e70e53776f9ded96284b10687e9\" alt=\"CircleCI\" />\n  </a>\n  <a href=\"#\">\n    <img src=\"https://img.shields.io/pypi/l/hydra-core\" alt=\"PyPI - License\" />\n  </a>\n  <a href=\"#\">\n    <img src=\"https://img.shields.io/pypi/pyversions/hydra-core\" alt=\"PyPI - Python Version\" />\n  </a>\n  <a href=\"https://pepy.tech/project/hydra-core?versions=0.11.*&versions=1.0.*&versions=1.1.*\">\n    <img src=\"https://pepy.tech/badge/hydra-core/month\" alt=\"Downloads\" />\n  </a>\n  <a href=\"https://github.com/psf/black\">\n    <img src=\"https://img.shields.io/badge/code%20style-black-000000.svg\" alt=\"Code style: black\" />\n  </a>\n  <a href=\"https://lgtm.com/projects/g/facebookresearch/hydra/alerts/\">\n    <img src=\"https://img.shields.io/lgtm/alerts/g/facebookresearch/hydra.svg?logo=lgtm&logoWidth=18\" alt=\"Total alerts\" />\n  </a>\n  <a href=\"https://lgtm.com/projects/g/facebookresearch/hydra/context:python\">\n    <img src=\"https://img.shields.io/lgtm/grade/python/g/facebookresearch/hydra.svg?logo=lgtm&logoWidth=18\" alt=\"Language grade: Python\" />\n  </a>\n  <p align=\"center\">\n    <i>A framework for elegantly configuring complex applications.</i>\n  </p>\n  <p align=\"center\">\n    <i>Check the <a href=\"https://hydra.cc/\">website</a> for more information,<br>\n    or click the thumbnail below for a one-minute video introduction to Hydra.</i>\n  </p>\n  <p align=\"center\">\n   <a href=\"http://www.youtube.com/watch?feature=player_embedded&v=Slc3gRQpnBI\" target=\"_blank\">\n     <img src=\"http://img.youtube.com/vi/Slc3gRQpnBI/hqdefault.jpg\" alt=\"1 minute overview\" width=\"240\" height=\"180\" border=\"10\" />\n   </a>\n  </p>\n</p>\n\n----------------------\n\n\n### Releases\n\n#### Stable\n\n**Hydra 1.3** is the stable version of Hydra.\n- [Documentation](https://hydra.cc/docs/1.3/intro/)\n- Installation : `pip install hydra-core --upgrade`\n\nSee the [NEWS.md](NEWS.md) file for a summary of recent changes to Hydra.\n\n### License\nHydra is licensed under [MIT License](LICENSE).\n\n## Hydra Ecosystem\n\n#### Check out these third-party libraries that build on Hydra's functionality:\n* [hydra-zen](https://github.com/mit-ll-responsible-ai/hydra-zen): Pythonic utilities for working with Hydra. Dynamic config generation capabilities, enhanced config store features, a Python API for launching Hydra jobs, and more.\n* [lightning-hydra-template](https://github.com/ashleve/lightning-hydra-template): user-friendly template combining Hydra with [Pytorch-Lightning](https://github.com/Lightning-AI/lightning) for ML experimentation.\n* [hydra-torch](https://github.com/pytorch/hydra-torch): [configen](https://github.com/facebookresearch/hydra/tree/main/tools/configen)-generated configuration classes enabling type-safe PyTorch configuration for Hydra apps.\n* NVIDIA's DeepLearningExamples repository contains a Hydra Launcher plugin, the [distributed_launcher](https://github.com/NVIDIA/DeepLearningExamples/tree/9c34e35c218514b8607d7cf381d8a982a01175e9/Tools/PyTorch/TimeSeriesPredictionPlatform/distributed_launcher), which makes use of the pytorch [distributed.launch](https://pytorch.org/docs/stable/distributed.html#launch-utility) API.\n\n#### Ask questions in Github Discussions or StackOverflow (Use the tag #fb-hydra or #omegaconf):\n* [Github Discussions](https://github.com/facebookresearch/hydra/discussions)\n* [StackOverflow](https://stackexchange.com/filters/391828/hydra-questions)\n* [Twitter](https://twitter.com/Hydra_Framework)\n\nCheck out the Meta AI [blog post](https://ai.facebook.com/blog/reengineering-facebook-ais-deep-learning-platforms-for-interoperability/) to learn about how Hydra fits into Meta's efforts to reengineer deep learning platforms for interoperability.\n\n### Citing Hydra\nIf you use Hydra in your research please use the following BibTeX entry:\n```BibTeX\n@Misc{Yadan2019Hydra,\n  author =       {Omry Yadan},\n  title =        {Hydra - A framework for elegantly configuring complex applications},\n  howpublished = {Github},\n  year =         {2019},\n  url =          {https://github.com/facebookresearch/hydra}\n}\n```\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A framework for elegantly configuring complex applications",
    "version": "1.3.2",
    "project_urls": {
        "Homepage": "https://github.com/facebookresearch/hydra"
    },
    "split_keywords": [
        "command-line",
        "configuration",
        "yaml",
        "tab-completion"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c650e0edd38dcd63fb26a8547f13d28f7a008bc4a3fd4eb4ff030673f22ad41a",
                "md5": "739fa52cf72a1e842bbfd655d5ffaf04",
                "sha256": "fa0238a9e31df3373b35b0bfb672c34cc92718d21f81311d8996a16de1141d8b"
            },
            "downloads": -1,
            "filename": "hydra_core-1.3.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "739fa52cf72a1e842bbfd655d5ffaf04",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 154547,
            "upload_time": "2023-02-23T18:33:40",
            "upload_time_iso_8601": "2023-02-23T18:33:40.801960Z",
            "url": "https://files.pythonhosted.org/packages/c6/50/e0edd38dcd63fb26a8547f13d28f7a008bc4a3fd4eb4ff030673f22ad41a/hydra_core-1.3.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6d8e07e42bc434a847154083b315779b0a81d567154504624e181caf2c71cd98",
                "md5": "14f283e037901a5a2c91978eefe6bc2b",
                "sha256": "8a878ed67216997c3e9d88a8e72e7b4767e81af37afb4ea3334b269a4390a824"
            },
            "downloads": -1,
            "filename": "hydra-core-1.3.2.tar.gz",
            "has_sig": false,
            "md5_digest": "14f283e037901a5a2c91978eefe6bc2b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 3263494,
            "upload_time": "2023-02-23T18:33:43",
            "upload_time_iso_8601": "2023-02-23T18:33:43.030739Z",
            "url": "https://files.pythonhosted.org/packages/6d/8e/07e42bc434a847154083b315779b0a81d567154504624e181caf2c71cd98/hydra-core-1.3.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-02-23 18:33:43",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "facebookresearch",
    "github_project": "hydra",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "circle": true,
    "lcname": "hydra-core"
}
        
Elapsed time: 0.29430s