nami-surf 0.1.0__tar.gz

nami_surf-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alexander Lutsenko
+
+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.

nami_surf-0.1.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.1
+Name: nami-surf
+Version: 0.1.0
+Summary: Node Administration Made Intuitive
+Author-email: Alexander Lutsenko <lex.lutsenko@gmail.com>
+Project-URL: Homepage, https://github.com/AlexanderLutsenko/nami
+Project-URL: Repository, https://github.com/AlexanderLutsenko/nami
+Project-URL: Bug Tracker, https://github.com/AlexanderLutsenko/nami/issues
+Keywords: ssh,rsync,s3,remote,administration,automation
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: paramiko>=3.4.0
+Requires-Dist: sty>=1.0.0
+
+# NAMI 🌊
+
+**N**ode **A**ccess & **M**anipulation **I**nterface is a simple tool for managing connections to multiple remote instances (particularly GPU servers), with built-in GPU monitoring, file transfer capabilities via rsync/S3, and a template system for common tasks.
+
+### Features
+
+- **🔗 Multi-instance SSH management** - Add, list, and connect to remote servers
+- **🌐 Heterogeneous environments** - Works across different Linux distros and cloud providers (Vast, AWS, Runpod, etc.)
+- **📊 GPU monitoring** - GPU utilization and memory tracking
+- **📁 File transfer** - Transfer files between instances directly via rsync or using S3 as intermediary
+- **📜 Template system** - Execute pre-configured bash script templates on remote instances  
+- **⚙️ Configuration management** - Personal and global configuration storage
+
+### Installation
+
+```bash
+pip install -U nami
+```
+
+### Quick Start
+
+```bash
+# Add a remote instance
+nami add gpu-box 192.168.1.100 22 --user ubuntu --description "Main GPU server"
+
+# List all instances with GPU status
+nami list
+
+# Connect to an instance via SSH  
+nami ssh gpu-box
+
+# Run a command on an instance
+nami ssh gpu-box "nvidia-smi"
+
+# Transfer files between instances
+nami transfer --source_instance local --dest_instance gpu-box --source_path ./data --dest_path ~/data
+
+# Upload files to S3 from an instance
+nami to_s3 --source_instance gpu-box --source_path ~/results --dest_path s3://bucket/experiment1/
+
+# Download files from S3 to an instance  
+nami from_s3 --dest_instance gpu-box --source_path s3://bucket/dataset/ --dest_path ~/data/
+
+# Execute a template on an instance
+nami template gpu-box setup_conda --env_name myenv --python_version 3.9
+```
+
+### ⚙️ Configuration
+
+NAMI stores its configuration in `~/.nami/`:
+
+- `config.yaml` - Instance definitions and global settings
+- `personal.yaml` - User-specific configurations (S3 bucket, AWS profile, etc.)
+- `templates/` - Custom bash script templates
+
+### 🔧 Commands
+
+**Instance Management:**
+```bash
+# Add a new instance
+nami add <name> <host> <port> [--user USER] [--local-port PORT] [--description DESC]
+
+# List all instances with GPU status
+nami list
+
+# Remove an instance
+nami remove <name>
+
+# Connect via SSH or run a command
+nami ssh <instance> [command]
+```
+
+**Configuration:**
+```bash
+# Set personal config value
+nami config set <key> <value>
+
+# Show configuration (all or specific key)
+nami config show [key]
+```
+
+**File Transfer:**
+```bash
+# Transfer files between instances
+nami transfer --source_instance SRC --dest_instance DEST \
+              --source_path PATH \
+              [--dest_path PATH] \
+              [--method rsync|s3] \
+              [--exclude PATTERNS] \
+              [--archive] \
+              [--rsync_opts "OPTIONS"]
+
+# Upload to S3
+nami to_s3 --source_instance INSTANCE \
+           --source_path PATH \
+           --dest_path S3_PATH \
+           [--exclude PATTERNS] \
+           [--archive] \
+           [--aws_profile PROFILE]
+
+# Download from S3  
+nami from_s3 --dest_instance INSTANCE \
+             --source_path S3_PATH \
+             --dest_path PATH \
+             [--exclude PATTERNS] \
+             [--archive] \
+             [--aws_profile PROFILE]
+```
+
+**Templates:**
+```bash
+# Execute a template with variables
+nami template <instance> <template_name> [--var1 value1 --var2 value2 ...]
+```

nami_surf-0.1.0/README.md

@@ -0,0 +1,114 @@
+# NAMI 🌊
+
+**N**ode **A**ccess & **M**anipulation **I**nterface is a simple tool for managing connections to multiple remote instances (particularly GPU servers), with built-in GPU monitoring, file transfer capabilities via rsync/S3, and a template system for common tasks.
+
+### Features
+
+- **🔗 Multi-instance SSH management** - Add, list, and connect to remote servers
+- **🌐 Heterogeneous environments** - Works across different Linux distros and cloud providers (Vast, AWS, Runpod, etc.)
+- **📊 GPU monitoring** - GPU utilization and memory tracking
+- **📁 File transfer** - Transfer files between instances directly via rsync or using S3 as intermediary
+- **📜 Template system** - Execute pre-configured bash script templates on remote instances  
+- **⚙️ Configuration management** - Personal and global configuration storage
+
+### Installation
+
+```bash
+pip install -U nami
+```
+
+### Quick Start
+
+```bash
+# Add a remote instance
+nami add gpu-box 192.168.1.100 22 --user ubuntu --description "Main GPU server"
+
+# List all instances with GPU status
+nami list
+
+# Connect to an instance via SSH  
+nami ssh gpu-box
+
+# Run a command on an instance
+nami ssh gpu-box "nvidia-smi"
+
+# Transfer files between instances
+nami transfer --source_instance local --dest_instance gpu-box --source_path ./data --dest_path ~/data
+
+# Upload files to S3 from an instance
+nami to_s3 --source_instance gpu-box --source_path ~/results --dest_path s3://bucket/experiment1/
+
+# Download files from S3 to an instance  
+nami from_s3 --dest_instance gpu-box --source_path s3://bucket/dataset/ --dest_path ~/data/
+
+# Execute a template on an instance
+nami template gpu-box setup_conda --env_name myenv --python_version 3.9
+```
+
+### ⚙️ Configuration
+
+NAMI stores its configuration in `~/.nami/`:
+
+- `config.yaml` - Instance definitions and global settings
+- `personal.yaml` - User-specific configurations (S3 bucket, AWS profile, etc.)
+- `templates/` - Custom bash script templates
+
+### 🔧 Commands
+
+**Instance Management:**
+```bash
+# Add a new instance
+nami add <name> <host> <port> [--user USER] [--local-port PORT] [--description DESC]
+
+# List all instances with GPU status
+nami list
+
+# Remove an instance
+nami remove <name>
+
+# Connect via SSH or run a command
+nami ssh <instance> [command]
+```
+
+**Configuration:**
+```bash
+# Set personal config value
+nami config set <key> <value>
+
+# Show configuration (all or specific key)
+nami config show [key]
+```
+
+**File Transfer:**
+```bash
+# Transfer files between instances
+nami transfer --source_instance SRC --dest_instance DEST \
+              --source_path PATH \
+              [--dest_path PATH] \
+              [--method rsync|s3] \
+              [--exclude PATTERNS] \
+              [--archive] \
+              [--rsync_opts "OPTIONS"]
+
+# Upload to S3
+nami to_s3 --source_instance INSTANCE \
+           --source_path PATH \
+           --dest_path S3_PATH \
+           [--exclude PATTERNS] \
+           [--archive] \
+           [--aws_profile PROFILE]
+
+# Download from S3  
+nami from_s3 --dest_instance INSTANCE \
+             --source_path S3_PATH \
+             --dest_path PATH \
+             [--exclude PATTERNS] \
+             [--archive] \
+             [--aws_profile PROFILE]
+```
+
+**Templates:**
+```bash
+# Execute a template with variables
+nami template <instance> <template_name> [--var1 value1 --var2 value2 ...]
+```

nami_surf-0.1.0/nami/__init__.py

@@ -0,0 +1,6 @@
+from .cli import main, Nami  # noqa: F401
+
+__all__ = [
+    "main",
+    "Nami",
+]