# # Raga CLI (rc) - Data Version Control Tool
Raga CLI (rc) is a command-line tool built in Python for managing data version control. It allows you to track changes to datasets and models, create checkpoints, and manage repositories to ensure smooth collaboration and reproducibility in data-related projects.
## Installation
To install Raga CLI, make sure you have Python installed, and then run the following command:
```bash
pip install raga-cli
```
## Usage
Raga CLI provides several commands to help you manage your data version control tasks. Here are the available commands:
1. **Create a New Repository**
```bash
rc repo create -n <repo_name> -tag <model/dataset>
```
This command creates a new repository with the specified name and tags it as a model or dataset repository.
2. **Clone an Existing Repository**
```bash
rc repo clone -n <repo_name>
```
Use this command to clone an existing repository by providing the repository name.
3. **Show Repository Current Local Version**
```bash
rc repo version
```
Displays the current local version of the repository.
4. **Show Repository Information**
```bash
rc repo info
```
Provides information about the repository, including its name, type, and current version.
5. **Upload Files and Create Checkpoint**
```bash
rc put -m "<commit message>"
```
Uploads tracked files or directories to remote storage and creates a checkpoint with the specified commit message.
6. **Download Tracked Files or Directories**
```bash
rc get
```
Downloads files or directories that are tracked by Raga CLI.
7. **Download Files or Directories of a Specific Repo Version**
```bash
rc get -repo-version <repo_version>
```
Downloads files or directories of a particular version of the repository.
### Additional Flags
- `-h`, `--help`: Prints the usage/help message and exits.
- `-q`, `--quiet`: Suppresses standard output. Exits with 0 if no problems arise; otherwise, exits with 1.
- `-v`, `--verbose`: Displays detailed tracing information.
## Contributing
Contributions to Raga CLI are welcome! If you encounter issues or have suggestions for improvements, feel free to open an issue or submit a pull request on the [GitHub repository](https://github.com/whoosh-labs/rctl).
## License
This project is licensed under the [MIT License](https://opensource.org/licenses/MIT).
---
Raw data
{
"_id": null,
"home_page": "",
"name": "raga-cli",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Manab Roy <manab.roy@raga.ai>",
"keywords": "data-science,data-version-control,machine-learning,git,developer-tools,reproducibility,collaboration,ai,raga",
"author": "",
"author_email": "Manab Roy <manab.roy@raga.ai>",
"download_url": "https://files.pythonhosted.org/packages/33/f3/a8ec271cb0ba6772b38bb15d2a877a28855892077219eae361619ddd50fa/raga-cli-0.1.78.tar.gz",
"platform": null,
"description": "\n# # Raga CLI (rc) - Data Version Control Tool\n\nRaga CLI (rc) is a command-line tool built in Python for managing data version control. It allows you to track changes to datasets and models, create checkpoints, and manage repositories to ensure smooth collaboration and reproducibility in data-related projects.\n\n## Installation\n\nTo install Raga CLI, make sure you have Python installed, and then run the following command:\n\n```bash\npip install raga-cli\n```\n\n## Usage\n\nRaga CLI provides several commands to help you manage your data version control tasks. Here are the available commands:\n\n1. **Create a New Repository**\n ```bash\n rc repo create -n <repo_name> -tag <model/dataset>\n ```\n This command creates a new repository with the specified name and tags it as a model or dataset repository.\n\n2. **Clone an Existing Repository**\n ```bash\n rc repo clone -n <repo_name>\n ```\n Use this command to clone an existing repository by providing the repository name.\n\n3. **Show Repository Current Local Version**\n ```bash\n rc repo version\n ```\n Displays the current local version of the repository.\n\n4. **Show Repository Information**\n ```bash\n rc repo info\n ```\n Provides information about the repository, including its name, type, and current version.\n\n5. **Upload Files and Create Checkpoint**\n ```bash\n rc put -m \"<commit message>\"\n ```\n Uploads tracked files or directories to remote storage and creates a checkpoint with the specified commit message.\n\n6. **Download Tracked Files or Directories**\n ```bash\n rc get\n ```\n Downloads files or directories that are tracked by Raga CLI.\n\n7. **Download Files or Directories of a Specific Repo Version**\n ```bash\n rc get -repo-version <repo_version>\n ```\n Downloads files or directories of a particular version of the repository.\n\n### Additional Flags\n\n- `-h`, `--help`: Prints the usage/help message and exits.\n- `-q`, `--quiet`: Suppresses standard output. Exits with 0 if no problems arise; otherwise, exits with 1.\n- `-v`, `--verbose`: Displays detailed tracing information.\n\n## Contributing\n\nContributions to Raga CLI are welcome! If you encounter issues or have suggestions for improvements, feel free to open an issue or submit a pull request on the [GitHub repository](https://github.com/whoosh-labs/rctl).\n\n## License\n\nThis project is licensed under the [MIT License](https://opensource.org/licenses/MIT).\n\n---\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Git for data scientists - manage your code and data together",
"version": "0.1.78",
"project_urls": {
"Bug Tracker": "https://github.com/whoosh-labs/rctl/issues",
"Homepage": "https://github.com/whoosh-labs/rctl"
},
"split_keywords": [
"data-science",
"data-version-control",
"machine-learning",
"git",
"developer-tools",
"reproducibility",
"collaboration",
"ai",
"raga"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "98216317472506c4f73d447714156f4dc6fd361f4793859c358be39bb3ac03b3",
"md5": "a552e333a208a0dde2891c87b57b8d13",
"sha256": "de0e7cc1a4d7615e98289a6d350c5d3bc2cd7ee5a76d2275cf5c9d20d62142e6"
},
"downloads": -1,
"filename": "raga_cli-0.1.78-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a552e333a208a0dde2891c87b57b8d13",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 49723,
"upload_time": "2023-09-05T14:18:34",
"upload_time_iso_8601": "2023-09-05T14:18:34.387906Z",
"url": "https://files.pythonhosted.org/packages/98/21/6317472506c4f73d447714156f4dc6fd361f4793859c358be39bb3ac03b3/raga_cli-0.1.78-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "33f3a8ec271cb0ba6772b38bb15d2a877a28855892077219eae361619ddd50fa",
"md5": "ee970dbf0dd8180959345dc628e58fb2",
"sha256": "3b6c1bd969cdca28d27f9fd4b33a0377849c9fe9aa275445d789ace01f18888c"
},
"downloads": -1,
"filename": "raga-cli-0.1.78.tar.gz",
"has_sig": false,
"md5_digest": "ee970dbf0dd8180959345dc628e58fb2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 40425,
"upload_time": "2023-09-05T14:18:36",
"upload_time_iso_8601": "2023-09-05T14:18:36.847458Z",
"url": "https://files.pythonhosted.org/packages/33/f3/a8ec271cb0ba6772b38bb15d2a877a28855892077219eae361619ddd50fa/raga-cli-0.1.78.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-05 14:18:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "whoosh-labs",
"github_project": "rctl",
"github_not_found": true,
"lcname": "raga-cli"
}
JSON
