diff --git a/README.md b/README.md index b9dadb0a..53b113cc 100644 --- a/README.md +++ b/README.md @@ -1,19 +1,19 @@ -# NeMo-Run +# NeMo Run > [!IMPORTANT] -> NeMo-Run is still in active development and this is a pre-release. The API is subject to change without notice while in pre-release. First official release will be 0.1.0 and will be included in NeMo FW 24.09 as well. +> NeMo Run is still in active development and this is a pre-release. The API is subject to change without notice while in pre-release. First official release will be 0.1.0 and will be included in NeMo FW 24.09 as well. -NeMo-Run is a powerful tool designed to streamline the configuration, execution, and management of machine learning experiments across various computing environments. NeMo-Run has three core responsibilities: +NeMo Run is a powerful tool designed to streamline the configuration, execution, and management of machine learning experiments across various computing environments. NeMo Run has three core responsibilities: 1. [Configuration](./docs/source/guides/configuration.md) 2. [Execution](./docs/source/guides/execution.md) 3. [Management](./docs/source/guides/management.md) -To learn more, click on each link. This represents the typical order that Nemo-Run users follow for setting up and launching experiments. +To learn more, click on each link. This represents the typical order that NeMo Run users follow for setting up and launching experiments. -- [NeMo-Run](#nemo-run) - - [Why Use Nemo-Run?](#why-use-nemo-run) - - [Install NeMo-Run](#install-nemo-run) +- [NeMo Run](#nemo-run) + - [Why Use NeMo Run?](#why-use-nemo-run) + - [Install NeMo Run](#install-nemo-run) - [Get Started](#get-started) - [Design Philosophy and Inspiration](#design-philosophy-and-inspiration) - [Pythonic](#pythonic) @@ -22,14 +22,14 @@ To learn more, click on each link. This represents the typical order that Nemo-R - [Set Up Once and Scale Easily](#set-up-once-and-scale-easily) - [Tutorials](#tutorials) - [Hello world](#hello-world) - - [Contribute to NeMo-Run](#contribute-to-nemo-run) + - [Contribute to NeMo Run](#contribute-to-nemo-run) - [FAQs](#faqs) -## Why Use Nemo-Run? -Please see this [detailed guide](./docs/source/guides/why-use-nemo-run.md) for reasons to use Nemo-Run. +## Why Use NeMo Run? +Please see this [detailed guide](./docs/source/guides/why-use-nemo-run.md) for reasons to use NeMo Run. -## Install NeMo-Run +## Install NeMo Run To install the project, use the following command: ```bash @@ -39,7 +39,7 @@ pip install git+https://github.com/NVIDIA/NeMo-Run.git Make sure you have `pip` installed and configured properly. ## Get Started -To get started with Nemo-Run, follow these three steps based on the core responsibilities mentioned above. For this example, we’ll showcase a pre-training example in Nemo 2.0 using Llama3. +To get started with NeMo Run, follow these three steps based on the core responsibilities mentioned above. For this example, we’ll showcase a pre-training example in Nemo 2.0 using Llama3. 1. Configure your function: ```python @@ -60,7 +60,7 @@ run.run(partial_func, executor=local_executor, name="llama3_8b_pretraining") ``` ## Design Philosophy and Inspiration -In building NeMo-Run, we drew inspiration from and relied on the following primary libraries. We would like to extend our gratitude for their work. +In building NeMo Run, we drew inspiration from and relied on the following primary libraries. We would like to extend our gratitude for their work. - [Fiddle](https://github.com/google/fiddle) - [TorchX](https://github.com/pytorch/torchx/) @@ -72,25 +72,25 @@ In building NeMo-Run, we drew inspiration from and relied on the following prima Apart from these, we also build on other libraries. A full list of dependencies can be found in [pyproject.toml](pyproject.toml). -NeMo-Run was designed keeping the following principles in mind: +NeMo Run was designed keeping the following principles in mind: ### Pythonic -In NeMo-Run, you can build and configure everything using Python, eliminating the need for multiple combinations of tools to manage your experiments. The only exception is when setting up the environment for remote execution, where we rely on Docker. +In NeMo Run, you can build and configure everything using Python, eliminating the need for multiple combinations of tools to manage your experiments. The only exception is when setting up the environment for remote execution, where we rely on Docker. ### Modular The decoupling of task and executor allows you to form different combinations of execution units with relative ease. You configure different remote environments once, and you can reuse it across a variety of tasks in a Pythonic way. ### Opinionated but Flexible -NeMo-Run is opinionated in some places, like storing of metadata information for experiments in a particular manner. However, it remains flexible enough to accommodate most user experiments. +NeMo Run is opinionated in some places, like storing of metadata information for experiments in a particular manner. However, it remains flexible enough to accommodate most user experiments. ### Set Up Once and Scale Easily -While it may take some time initially for users to become familiar with NeMo-Run concepts, the tool is designed to scale experimentation in a fluid and easy manner. +While it may take some time initially for users to become familiar with NeMo Run concepts, the tool is designed to scale experimentation in a fluid and easy manner. ## Tutorials #### Hello world -The `hello_world` tutorial series provides a comprehensive introduction to NeMo-Run, demonstrating its capabilities through a simple example. The tutorial covers: +The `hello_world` tutorial series provides a comprehensive introduction to NeMo Run, demonstrating its capabilities through a simple example. The tutorial covers: - Configuring Python functions using `Partial` and `Config` classes. - Executing configured functions locally and on remote clusters. @@ -102,7 +102,7 @@ You can find the tutorial series below: - [Part 2](examples/hello-world/hello_experiments.ipynb). - [Part 3](examples/hello-world/hello_scripts.py). -## Contribute to NeMo-Run +## Contribute to NeMo Run Please see the [contribution guide](./CONTRIBUTING.md) to contribute to NeMo Run. ## FAQs