jetson-cli 0.2.0__tar.gz

jetson_cli-0.2.0/CLAUDE.md

@@ -0,0 +1,126 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This repository is a Jetson setup system that includes the `jetson-containers` framework - a modular container build system for AI/ML packages on NVIDIA Jetson devices. The repository provides system setup scripts and integrates the jetson-containers framework as a Git submodule.
+
+## Common Commands
+
+### Jetson CLI (Recommended)
+```bash
+# Install the CLI package globally
+pip install jetson-cli
+
+# System operations
+jetson-cli probe                        # analyze system configuration
+jetson-cli init                         # create environment profile
+jetson-cli setup                        # complete system setup
+jetson-cli configure docker             # configure specific components
+jetson-cli status                       # show system status
+```
+
+### Container Building
+```bash
+# Install the container tools
+bash jetson-containers/install.sh
+
+# Build a container with specific packages
+jetson-containers build pytorch                    # single package
+jetson-containers build pytorch jupyterlab         # multiple packages chained
+jetson-containers build --multiple pytorch tensorflow  # separate containers
+jetson-containers build --name=my_container pytorch    # custom name
+
+# List available packages
+jetson-containers build --list-packages
+jetson-containers build --show-packages
+```
+
+### Running Containers
+```bash
+# Run a container (pulls/builds if needed)
+jetson-containers run $(autotag l4t-pytorch)
+
+# Manual docker run
+sudo docker run --runtime nvidia -it --rm --network=host dustynv/l4t-pytorch:r36.2.0
+```
+
+### System Setup (Direct Scripts)
+```bash
+# Run system setup scripts directly
+./scripts/setup-system.sh              # main system configuration
+./scripts/configure-docker.sh          # Docker daemon setup
+./scripts/configure-swap.sh            # memory/swap tuning
+./scripts/configure-ssd.sh             # storage configuration
+```
+
+## Architecture
+
+### Core Structure
+- **`jetson-containers/`**: Git submodule containing the main container framework
+  - `jetson_containers/`: Python modules for build system (`build.py`, `container.py`, `packages.py`)
+  - `packages/`: Container package definitions organized by category (llm/, ml/, robotics/, etc.)
+  - `build.sh`/`run.sh`: Wrapper scripts for container operations
+  - `install.sh`: System installation script
+
+- **`scripts/`**: System configuration scripts for Jetson devices
+  - Environment setup, Docker configuration, hardware tuning
+
+- **`jetson_cli/`**: Python CLI package for system management
+  - `cli.py`: Main Click-based command interface
+  - `utils.py`: Platform detection and script execution utilities
+  - Provides user-friendly interface to underlying scripts
+
+### Package System
+The container framework uses a modular package system where:
+- Each package has a `Dockerfile` and optional `config.py` for dynamic configuration
+- Packages specify dependencies, build requirements, and metadata via YAML headers or config files
+- The build system resolves dependencies and chains Dockerfiles together
+- Base images default to JetPack-compatible containers (l4t-base, l4t-jetpack, or ubuntu)
+
+### Container Categories
+- **ML/AI**: PyTorch, TensorFlow, ONNX Runtime, transformers
+- **LLM**: SGLang, vLLM, MLC, text-generation-webui, ollama, llama.cpp
+- **VLM**: LLaVA, VILA, NanoLLM (vision-language models)
+- **Robotics**: ROS, Genesis, OpenVLA, LeRobot
+- **Computer Vision**: NanoOWL, SAM, CLIP, DeepStream
+- **Graphics**: Stable Diffusion, ComfyUI, NeRF Studio
+
+### Build Process
+1. Package scanning finds available packages under `jetson-containers/packages/`
+2. Dependency resolution determines build order
+3. Dockerfiles are chained together with intermediate images
+4. Build commands and logs are saved under `jetson-containers/logs/`
+5. Containers are tagged with L4T/JetPack version compatibility
+
+## Testing
+Test scripts are typically included with each package as `test.py` or `test.sh` files. The build system can run tests automatically during container builds.
+
+## Version Management
+- `CUDA_VERSION`: Can be overridden to rebuild stack for different CUDA versions
+- `L4T_VERSION`: Automatically detected JetPack/L4T version for compatibility
+- Package versions are managed through config files and can be pinned or dynamically selected
+
+## CLI Package Development
+
+### Installation
+```bash
+# Development installation
+pip install -e .
+
+# Production installation
+pip install jetson-cli
+```
+
+### GitHub Actions Pipelines
+- **CI Pipeline**: Tests across Python versions, linting, security scans
+- **Release Pipeline**: Automated version bumping and PyPI publishing on main branch merges
+- **Installation Testing**: Validates package installation across environments
+
+### CLI Commands Reference
+- `jetson-cli probe [--output table|json|yaml] [--save file]`: System analysis
+- `jetson-cli init [--profile-name name] [--force]`: Environment profile creation  
+- `jetson-cli setup [--skip-docker] [--skip-swap] [--interactive]`: Complete setup
+- `jetson-cli configure <docker|swap|ssd|power|gui>`: Component configuration
+- `jetson-cli status [--format table|json]`: System status overview

jetson_cli-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ori Nachum
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

jetson_cli-0.2.0/MANIFEST.in

@@ -0,0 +1,21 @@
+include README.md
+include LICENSE
+include CLAUDE.md
+include pyproject.toml
+include setup.py
+
+recursive-include jetson_cli *.py
+recursive-include jetson_cli/scripts *.sh
+recursive-include jetson_cli/config *.yaml *.yml *.json
+
+recursive-include scripts *.sh *.yaml *.yml
+recursive-include docs *.md
+
+exclude .gitignore
+exclude .github/workflows/*
+exclude tests/*
+exclude jetson-containers/*
+
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude .DS_Store

jetson_cli-0.2.0/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: jetson-cli
+Version: 0.2.0
+Summary: Command-line interface for NVIDIA Jetson setup and configuration
+Home-page: https://github.com/your-org/jetson-setup
+Author: Jetson Setup Team
+Author-email: Jetson Setup Team <support@jetson-setup.com>
+License: MIT
+Project-URL: Homepage, https://github.com/your-org/jetson-setup
+Project-URL: Documentation, https://github.com/your-org/jetson-setup/blob/main/README.md
+Project-URL: Repository, https://github.com/your-org/jetson-setup.git
+Project-URL: Bug Reports, https://github.com/your-org/jetson-setup/issues
+Keywords: jetson,nvidia,embedded,ai,ml,docker,containers,setup
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tabulate>=0.9.0
+Requires-Dist: packaging>=20.0
+Requires-Dist: psutil>=5.8.0
+Requires-Dist: rich>=12.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: black>=22.0; extra == "dev"
+Requires-Dist: flake8>=4.0; extra == "dev"
+Requires-Dist: isort>=5.0; extra == "dev"
+Requires-Dist: bump2version>=1.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# jetson-cli
+
+A comprehensive CLI tool for setting up NVIDIA Jetson devices and building containerized AI/ML applications using the jetson-containers framework.
+
+## Overview
+
+jetson-cli provides a streamlined interface for:
+- Analyzing and configuring Jetson hardware
+- Setting up development environments
+- Building and running containerized AI/ML applications
+- Managing the jetson-containers ecosystem
+
+## Installation
+
+### From PyPI (Recommended)
+```bash
+pip install jetson-cli
+```
+
+### From Source
+```bash
+git clone https://github.com/orinachum/jetson-cli.git
+cd jetson-cli
+pip install -e .
+```
+
+## Quick Start
+
+1. **Analyze your system**:
+   ```bash
+   jetson-cli probe
+   ```
+
+2. **Initialize environment**:
+   ```bash
+   jetson-cli init
+   ```
+
+3. **Complete setup**:
+   ```bash
+   jetson-cli setup
+   ```
+
+## Commands
+
+### System Analysis
+```bash
+jetson-cli probe                        # Show system configuration
+jetson-cli probe --output json          # Output as JSON
+jetson-cli probe --save config.yaml     # Save to file
+```
+
+### Environment Setup
+```bash
+jetson-cli init                         # Create environment profile
+jetson-cli init --profile-name dev      # Custom profile name
+jetson-cli init --force                 # Overwrite existing profile
+```
+
+### System Configuration
+```bash
+jetson-cli setup                        # Complete system setup
+jetson-cli setup --skip-docker          # Skip Docker configuration
+jetson-cli setup --interactive          # Interactive mode
+```
+
+### Component Management
+```bash
+jetson-cli configure docker             # Configure Docker daemon
+jetson-cli configure swap               # Setup swap file
+jetson-cli configure ssd                # Configure SSD storage
+jetson-cli configure power              # Power management settings
+jetson-cli configure gui                # GUI environment setup
+```
+
+### Status Monitoring
+```bash
+jetson-cli status                       # Show system status
+jetson-cli status --format json         # JSON output format
+```
+
+## jetson-containers Integration
+
+This tool integrates with the [jetson-containers](https://github.com/dusty-nv/jetson-containers) framework to provide containerized AI/ML packages:
+
+### Container Building
+```bash
+# After jetson-cli setup, use jetson-containers directly
+jetson-containers build pytorch                    # Build PyTorch container
+jetson-containers build pytorch jupyterlab         # Chain multiple packages
+jetson-containers build --name=my_app pytorch      # Custom container name
+```
+
+### Available Packages
+- **ML/AI**: PyTorch, TensorFlow, ONNX Runtime, transformers
+- **LLM**: SGLang, vLLM, MLC, text-generation-webui, ollama
+- **VLM**: LLaVA, VILA, NanoLLM (vision-language models)
+- **Robotics**: ROS, Genesis, OpenVLA, LeRobot
+- **Computer Vision**: NanoOWL, SAM, CLIP, DeepStream
+- **Graphics**: Stable Diffusion, ComfyUI, NeRF Studio
+
+### Running Containers
+```bash
+jetson-containers run $(autotag l4t-pytorch)
+```
+
+## Examples
+
+### Complete Jetson Setup Workflow
+```bash
+# 1. Analyze hardware and software configuration
+jetson-cli probe --save system-info.yaml
+
+# 2. Create development environment profile
+jetson-cli init --profile-name ml-dev
+
+# 3. Configure the system for AI/ML development
+jetson-cli setup
+
+# 4. Verify everything is working
+jetson-cli status
+
+# 5. Build and run your first container
+jetson-containers build pytorch
+jetson-containers run $(autotag l4t-pytorch)
+```
+
+### Selective Component Configuration
+```bash
+# Configure only Docker (skip other components)
+jetson-cli configure docker
+
+# Setup additional swap space
+jetson-cli configure swap
+
+# Configure external SSD storage
+jetson-cli configure ssd
+```
+
+## Architecture
+
+- **CLI Interface** (`jetson_cli/`): User-friendly Click-based commands
+- **System Scripts** (`scripts/`): Low-level system configuration scripts
+- **Container Framework** (`jetson-containers/`): Modular container build system
+- **Package Ecosystem**: 100+ pre-built AI/ML container packages
+
+## Requirements
+
+- NVIDIA Jetson device (Nano, Xavier, Orin series)
+- JetPack 4.6+ or L4T R32.7+
+- Python 3.6+
+- Docker support
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

jetson_cli-0.2.0/README.md

@@ -0,0 +1,164 @@
+# jetson-cli
+
+A comprehensive CLI tool for setting up NVIDIA Jetson devices and building containerized AI/ML applications using the jetson-containers framework.
+
+## Overview
+
+jetson-cli provides a streamlined interface for:
+- Analyzing and configuring Jetson hardware
+- Setting up development environments
+- Building and running containerized AI/ML applications
+- Managing the jetson-containers ecosystem
+
+## Installation
+
+### From PyPI (Recommended)
+```bash
+pip install jetson-cli
+```
+
+### From Source
+```bash
+git clone https://github.com/orinachum/jetson-cli.git
+cd jetson-cli
+pip install -e .
+```
+
+## Quick Start
+
+1. **Analyze your system**:
+   ```bash
+   jetson-cli probe
+   ```
+
+2. **Initialize environment**:
+   ```bash
+   jetson-cli init
+   ```
+
+3. **Complete setup**:
+   ```bash
+   jetson-cli setup
+   ```
+
+## Commands
+
+### System Analysis
+```bash
+jetson-cli probe                        # Show system configuration
+jetson-cli probe --output json          # Output as JSON
+jetson-cli probe --save config.yaml     # Save to file
+```
+
+### Environment Setup
+```bash
+jetson-cli init                         # Create environment profile
+jetson-cli init --profile-name dev      # Custom profile name
+jetson-cli init --force                 # Overwrite existing profile
+```
+
+### System Configuration
+```bash
+jetson-cli setup                        # Complete system setup
+jetson-cli setup --skip-docker          # Skip Docker configuration
+jetson-cli setup --interactive          # Interactive mode
+```
+
+### Component Management
+```bash
+jetson-cli configure docker             # Configure Docker daemon
+jetson-cli configure swap               # Setup swap file
+jetson-cli configure ssd                # Configure SSD storage
+jetson-cli configure power              # Power management settings
+jetson-cli configure gui                # GUI environment setup
+```
+
+### Status Monitoring
+```bash
+jetson-cli status                       # Show system status
+jetson-cli status --format json         # JSON output format
+```
+
+## jetson-containers Integration
+
+This tool integrates with the [jetson-containers](https://github.com/dusty-nv/jetson-containers) framework to provide containerized AI/ML packages:
+
+### Container Building
+```bash
+# After jetson-cli setup, use jetson-containers directly
+jetson-containers build pytorch                    # Build PyTorch container
+jetson-containers build pytorch jupyterlab         # Chain multiple packages
+jetson-containers build --name=my_app pytorch      # Custom container name
+```
+
+### Available Packages
+- **ML/AI**: PyTorch, TensorFlow, ONNX Runtime, transformers
+- **LLM**: SGLang, vLLM, MLC, text-generation-webui, ollama
+- **VLM**: LLaVA, VILA, NanoLLM (vision-language models)
+- **Robotics**: ROS, Genesis, OpenVLA, LeRobot
+- **Computer Vision**: NanoOWL, SAM, CLIP, DeepStream
+- **Graphics**: Stable Diffusion, ComfyUI, NeRF Studio
+
+### Running Containers
+```bash
+jetson-containers run $(autotag l4t-pytorch)
+```
+
+## Examples
+
+### Complete Jetson Setup Workflow
+```bash
+# 1. Analyze hardware and software configuration
+jetson-cli probe --save system-info.yaml
+
+# 2. Create development environment profile
+jetson-cli init --profile-name ml-dev
+
+# 3. Configure the system for AI/ML development
+jetson-cli setup
+
+# 4. Verify everything is working
+jetson-cli status
+
+# 5. Build and run your first container
+jetson-containers build pytorch
+jetson-containers run $(autotag l4t-pytorch)
+```
+
+### Selective Component Configuration
+```bash
+# Configure only Docker (skip other components)
+jetson-cli configure docker
+
+# Setup additional swap space
+jetson-cli configure swap
+
+# Configure external SSD storage
+jetson-cli configure ssd
+```
+
+## Architecture
+
+- **CLI Interface** (`jetson_cli/`): User-friendly Click-based commands
+- **System Scripts** (`scripts/`): Low-level system configuration scripts
+- **Container Framework** (`jetson-containers/`): Modular container build system
+- **Package Ecosystem**: 100+ pre-built AI/ML container packages
+
+## Requirements
+
+- NVIDIA Jetson device (Nano, Xavier, Orin series)
+- JetPack 4.6+ or L4T R32.7+
+- Python 3.6+
+- Docker support
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

jetson_cli-0.2.0/docs/requests/jetson-cli-package.md

@@ -0,0 +1,148 @@
+# Request: Jetson CLI Package Development
+
+**Date**: 2025-07-26  
+**Status**: In Progress  
+**Priority**: High  
+
+## Overview
+
+Create a `jetson-cli` pip package that provides a command-line interface for NVIDIA Jetson setup and configuration, with automated GitHub pipelines for deployment and release management.
+
+## Requirements
+
+### Core CLI Commands
+
+1. **`jetson-cli probe`** - System probing and analysis
+   - Maps to: `scripts/probe-system.sh`
+   - Output formats: table, JSON, YAML
+   - Save results to file option
+
+2. **`jetson-cli init`** - Environment profile creation
+   - Maps to: `scripts/create-env-profile.sh`
+   - Custom profile naming
+   - Force recreate option
+
+3. **`jetson-cli setup`** - Complete system setup
+   - Maps to: `scripts/setup-system.sh`
+   - Interactive/non-interactive modes
+   - Skip individual components (docker, swap, ssd)
+
+4. **`jetson-cli configure <component>`** - Individual component configuration
+   - Components: docker, swap, ssd, power, gui
+   - Maps to respective `configure-*.sh` scripts
+
+5. **`jetson-cli status`** - System status overview
+   - Show current configuration state
+   - Multiple output formats
+
+### Package Structure
+
+```
+jetson-cli/
+├── setup.py                    # Package configuration
+├── jetson_cli/
+│   ├── __init__.py             # Version and package info
+│   ├── cli.py                  # Main CLI interface using Click
+│   ├── utils.py                # Utility functions
+│   ├── scripts/                # Embedded scripts (if needed)
+│   └── config/                 # Configuration files
+├── tests/                      # Unit tests
+├── docs/                       # Documentation
+└── .github/workflows/          # CI/CD pipelines
+```
+
+### GitHub Actions Pipelines
+
+#### 1. CI Pipeline (`.github/workflows/ci.yml`)
+- **Triggers**: Push to main/develop, Pull requests
+- **Jobs**:
+  - Test across Python 3.8-3.12
+  - Code linting (flake8, black, isort)
+  - Shell script linting (shellcheck)
+  - Security scanning (bandit)
+  - CLI functionality testing
+
+#### 2. Release Pipeline (`.github/workflows/release.yml`)
+- **Triggers**: Push to main branch, Manual workflow dispatch
+- **Features**:
+  - Automated version bumping (minor on merge to main)
+  - Smart version detection from commit messages
+  - PyPI package publishing
+  - GitHub release creation
+  - Release notes generation
+
+#### 3. Installation Testing (`.github/workflows/test-install.yml`)
+- **Triggers**: New releases
+- **Tests**:
+  - PyPI installation across Python versions
+  - Docker-based installation testing
+  - CLI functionality verification
+
+### Version Management
+
+- **Automatic Minor Bump**: On merge to main branch
+- **Manual Version Control**: Workflow dispatch with patch/minor/major options
+- **Semantic Versioning**: Based on commit message analysis
+- **Release Assets**: Wheel files, release notes, changelog
+
+### Dependencies
+
+- **Runtime**: click, pyyaml, tabulate, packaging, psutil, rich
+- **Development**: pytest, flake8, black, isort, bump2version
+- **CI/CD**: GitHub Actions, PyPI publishing, automated testing
+
+## Implementation Status
+
+### ✅ Completed
+- [x] Package structure (`setup.py`, `__init__.py`)
+- [x] CLI interface with Click framework
+- [x] Core command implementations (probe, init, setup, configure, status)
+- [x] Utility functions for script execution and platform detection
+- [x] GitHub Actions CI pipeline
+- [x] Automated release pipeline with version management
+- [x] Installation testing workflow
+
+### 🔄 In Progress
+- [ ] Integration with existing shell scripts
+- [ ] Comprehensive testing suite
+- [ ] Documentation and usage examples
+
+### ⏳ Pending
+- [ ] PyPI account setup and API token configuration
+- [ ] Repository secrets configuration (PYPI_API_TOKEN)
+- [ ] Beta testing and feedback integration
+- [ ] Production deployment
+
+## Technical Considerations
+
+### Platform Detection
+- Jetson platform detection via device tree and hardware indicators
+- Graceful fallback for non-Jetson environments
+- Environment variable override for testing
+
+### Script Integration
+- Scripts embedded in package or referenced from repository
+- Proper error handling and user feedback
+- Progress indicators for long-running operations
+
+### User Experience
+- Rich CLI output with colors and progress bars
+- Comprehensive help text and examples
+- Consistent command patterns and options
+
+## Success Criteria
+
+1. **Functional**: All CLI commands work correctly on Jetson platforms
+2. **Installable**: `pip install jetson-cli` works globally
+3. **Automated**: Releases happen automatically on main branch merges
+4. **Tested**: Comprehensive test coverage and CI validation
+5. **Documented**: Clear usage instructions and API documentation
+
+## Next Steps
+
+1. Configure PyPI account and repository secrets
+2. Test the complete CI/CD pipeline
+3. Create comprehensive test suite
+4. Beta release for community feedback
+5. Documentation and tutorial creation
+6. Production release announcement