[](https://github.com/nvidia-holoscan/holoscan-cli/actions/workflows/check.yaml)
[](https://coveralls.io/github/nvidia-holoscan/holoscan-cli?branch=vchang/poetry-setup)
# Holoscan CLI
Command line interface for packaging and running Holoscan applications.
## Overview
This repository is the home for Holoscan CLI. It includes tools for packaging and running Holoscan applications.
## Prerequisites
You will need a platform supported by [NVIDIA Holoscan SDK](https://docs.nvidia.com/holoscan/sdk-user-guide/sdk_installation.html#prerequisites). Refer to the Holoscan SDK User Guide for the latest requirements. In general, Holoscan-supported platforms include:
- An x64 PC with an Ubuntu operating system and an NVIDIA GPU or
- A supported NVIDIA ARM development kit.
## Installation
Holoscan CLI is delivered as a Python package and can be installed from PyPI.org using one of the following commands:
| Holoscan SDK Version | Installation Command |
| -------------------- | -------------------------- |
| 2.8 or earlier | `pip install holoscan` |
| 2.9 or later | `pip install holoscan-cli` |
## Build From Source
### Prerequisites
To build the Holoscan CLI from source, you will need to clone this repository and install the following dependencies:
- Python 3.9+.
- [poetry 2.0+](https://python-poetry.org/docs/#installation)
### Development Environment
Holoscan CLI uses [Poetry](https://python-poetry.org/) for package and dependency management. After installing Poetry, run the following commands to get started:
```bash
# Create virtual environment
poetry shell
# Install dependencies
poetry install
# Configure pre-commmit hooks
pre-commit install
# Run pre-commit against all files
pre-commit run --all-files
# Build sdist package
poetry build
# Run tests
poetry run pytest
```
## Contributing to the Holoscan CLI
See [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "holoscan-cli",
"maintainer": "mocsharp",
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": "AI, holoscan, medical, streaming, HPC, nvidia, docker, container",
"author": "NVIDIA",
"author_email": null,
"download_url": null,
"platform": null,
"description": "[](https://github.com/nvidia-holoscan/holoscan-cli/actions/workflows/check.yaml)\n[](https://coveralls.io/github/nvidia-holoscan/holoscan-cli?branch=vchang/poetry-setup)\n\n# Holoscan CLI\n\nCommand line interface for packaging and running Holoscan applications.\n\n## Overview\n\nThis repository is the home for Holoscan CLI. It includes tools for packaging and running Holoscan applications.\n\n## Prerequisites\n\nYou will need a platform supported by [NVIDIA Holoscan SDK](https://docs.nvidia.com/holoscan/sdk-user-guide/sdk_installation.html#prerequisites). Refer to the Holoscan SDK User Guide for the latest requirements. In general, Holoscan-supported platforms include:\n\n- An x64 PC with an Ubuntu operating system and an NVIDIA GPU or\n- A supported NVIDIA ARM development kit.\n\n## Installation\n\nHoloscan CLI is delivered as a Python package and can be installed from PyPI.org using one of the following commands:\n\n| Holoscan SDK Version | Installation Command |\n| -------------------- | -------------------------- |\n| 2.8 or earlier | `pip install holoscan` |\n| 2.9 or later | `pip install holoscan-cli` |\n\n## Build From Source\n\n### Prerequisites\n\nTo build the Holoscan CLI from source, you will need to clone this repository and install the following dependencies:\n\n- Python 3.9+.\n- [poetry 2.0+](https://python-poetry.org/docs/#installation)\n\n### Development Environment\n\nHoloscan CLI uses [Poetry](https://python-poetry.org/) for package and dependency management. After installing Poetry, run the following commands to get started:\n\n```bash\n# Create virtual environment\npoetry shell\n\n# Install dependencies\npoetry install\n\n# Configure pre-commmit hooks\npre-commit install\n\n# Run pre-commit against all files\npre-commit run --all-files\n\n# Build sdist package\npoetry build\n\n# Run tests\npoetry run pytest\n```\n\n## Contributing to the Holoscan CLI\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for details.\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Command line interface for packaging and running Holoscan applications.",
"version": "2.9.0",
"project_urls": {
"Documentation": "https://docs.nvidia.com/holoscan/sdk-user-guide/index.html",
"Homepage": "https://github.com/nvidia-holoscan/holoscan-cli",
"Repository": "https://github.com/nvidia-holoscan/holoscan-cli"
},
"split_keywords": [
"ai",
" holoscan",
" medical",
" streaming",
" hpc",
" nvidia",
" docker",
" container"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "32dacebd80cdbd426f897b00df079d8ef9d3c7194f91380df658759d6f96bb9b",
"md5": "0b9be4d0294121af7b67be5327e7256d",
"sha256": "dc8ad37e5da34ad6d4c499b6427816213d2fa22b41f48b370de7a1e997aa0879"
},
"downloads": -1,
"filename": "holoscan_cli-2.9.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0b9be4d0294121af7b67be5327e7256d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 72775,
"upload_time": "2025-02-14T06:58:29",
"upload_time_iso_8601": "2025-02-14T06:58:29.256117Z",
"url": "https://files.pythonhosted.org/packages/32/da/cebd80cdbd426f897b00df079d8ef9d3c7194f91380df658759d6f96bb9b/holoscan_cli-2.9.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-14 06:58:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nvidia-holoscan",
"github_project": "holoscan-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "holoscan-cli"
}
JSON
