godfather-cli 1.0.1__tar.gz

godfather_cli-1.0.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include godfather_cli *.py

godfather_cli-1.0.1/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: godfather-cli
+Version: 1.0.1
+Summary: AI Society Godfather CLI - RunPod Environment Manager
+Author-email: AI Society ASU <theaisocietyasu@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/theaisocietyasu/godfather
+Project-URL: Repository, https://github.com/theaisocietyasu/godfather
+Project-URL: Issues, https://github.com/theaisocietyasu/godfather/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: rich>=13.0.0
+
+# Godfather CLI
+
+Beautiful command-line interface for managing AI Society ASU RunPod environments.
+
+![CLI Demo](https://img.shields.io/badge/python-3.7+-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+
+## ✨ Features
+
+- 🎨 **Beautiful Interface** - Rich terminal UI with colors, tables, and panels
+- 🔐 **Secure Authentication** - Discord-based authentication
+- 🚀 **Pod Management** - List and connect to available RunPod environments
+- 🔌 **SSH Integration** - Automatic SSH key setup and connection
+- 📊 **Status Monitoring** - Check authentication and configuration status
+
+## 📦 Installation
+
+### Option 1: Install from PyPI (Recommended)
+
+```bash
+pip install godfather-cli
+```
+
+### Option 2: Install from GitHub
+
+```bash
+pip install git+https://github.com/theaisocietyasu/godfather.git#subdirectory=cli
+```
+
+### Option 3: Install for Development
+
+```bash
+git clone https://github.com/theaisocietyasu/godfather.git
+cd godfather/cli
+pip install -e .
+```
+
+## 🚀 Quick Start
+
+1. **Run the CLI**:
+   ```bash
+   godfather
+   ```
+
+2. **Authenticate**:
+   - Visit the admin portal to get your authentication token
+   - Paste the token when prompted
+
+3. **Connect to a Pod**:
+   - Select option `2` to connect to a pod
+   - Choose from available pods
+   - Automatically SSH into your isolated workspace
+
+## 📖 Usage
+
+### Interactive Menu
+
+Simply run:
+```bash
+godfather
+```
+
+You'll see a beautiful menu:
+```
+╔═══════════════════════════════════════╗
+║ Godfather CLI                         ║
+║ AI Society RunPod Environment Manager ║
+╚═══════════════════════════════════════╝
+
+╭──────── What would you like to do? ──────────╮
+│ 1.  📋 List available pods                   │
+│ 2.  🔌 Connect to a pod                      │
+│ 3.  📊 Show status                           │
+│ 4.  🚪 Logout                                │
+│ 5.  👋 Exit                                  │
+╰──────────────────────────────────────────────╯
+```
+
+### Command-Line Interface
+
+```bash
+# List available pods
+godfather list
+
+# Connect to a specific pod
+godfather connect <pod-id>
+
+# Connect interactively
+godfather connect
+
+# Show CLI status
+godfather status
+
+# Logout
+godfather logout
+
+# Re-authenticate
+godfather auth
+
+# Use custom API URL
+godfather --api-url https://your-api.com list
+```
+
+## 🔑 Authentication
+
+1. Get your authentication token from: `https://your-godfather-instance.com/cli-auth`
+2. Run `godfather` or `godfather auth`
+3. Paste your token when prompted
+4. Token is securely stored in `~/.godfather/config.json`
+
+## 🛠️ Configuration
+
+Configuration is stored in `~/.godfather/config.json`:
+
+```json
+{
+  "token": "discord_<user_id>_<timestamp>",
+  "discord_user_id": "<your_discord_id>"
+}
+```
+
+### Environment Variables
+
+You can override the API URL with:
+
+```bash
+export GODFATHER_API_URL="https://your-api.com"
+# or
+export BACKEND_URL="https://your-api.com"
+# or
+export NEXT_PUBLIC_BACKEND_URL="https://your-api.com"
+```
+
+## 🎨 Features in Detail
+
+### Beautiful Tables
+
+Pod listings display in rich, colorful tables:
+
+```
+           🚀 Available Pods (3)
+╭───┬────────┬─────────────┬──────────────┬───────────╮
+│ # │ Status │ Name        │ ID           │ Created   │
+├───┼────────┼─────────────┼──────────────┼───────────┤
+│ 1 │ 🟢 RUN │ ml-training │ abc123def... │ 2 days ago│
+│ 2 │ 🟢 RUN │ gpu-dev     │ xyz789ghi... │ 1 week ago│
+│ 3 │ 🔴 OFF │ testing     │ jkl456mno... │ 3 days ago│
+╰───┴────────┴─────────────┴──────────────┴───────────╯
+```
+
+### Status Dashboard
+
+```
+        Godfather CLI Status
+╭─────────────────────┬─────────────────────────────╮
+│ 🔐 Authentication   │ ✓ Authenticated             │
+│ 🌐 API Connection   │ ✓ Connected                 │
+│ 🏠 Config Directory │ /home/user/.godfather       │
+│ 🔗 API Endpoint     │ https://api.example.com     │
+╰─────────────────────┴─────────────────────────────╯
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+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.
+
+## 🆘 Support
+
+- **Issues**: [GitHub Issues](https://github.com/theaisocietyasu/godfather/issues)
+- **Discord**: Contact AI Society ASU administrators
+- **Email**: admin@ais-asu.com
+
+## 🎓 About
+
+Built with ❤️ by [AI Society at Arizona State University](https://github.com/theaisocietyasu)
+
+---
+
+**Note**: You need to be a member of the AI Society Discord server with appropriate permissions to use this CLI.

godfather_cli-1.0.1/README.md

@@ -0,0 +1,189 @@
+# Godfather CLI
+
+Beautiful command-line interface for managing AI Society ASU RunPod environments.
+
+![CLI Demo](https://img.shields.io/badge/python-3.7+-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+
+## ✨ Features
+
+- 🎨 **Beautiful Interface** - Rich terminal UI with colors, tables, and panels
+- 🔐 **Secure Authentication** - Discord-based authentication
+- 🚀 **Pod Management** - List and connect to available RunPod environments
+- 🔌 **SSH Integration** - Automatic SSH key setup and connection
+- 📊 **Status Monitoring** - Check authentication and configuration status
+
+## 📦 Installation
+
+### Option 1: Install from PyPI (Recommended)
+
+```bash
+pip install godfather-cli
+```
+
+### Option 2: Install from GitHub
+
+```bash
+pip install git+https://github.com/theaisocietyasu/godfather.git#subdirectory=cli
+```
+
+### Option 3: Install for Development
+
+```bash
+git clone https://github.com/theaisocietyasu/godfather.git
+cd godfather/cli
+pip install -e .
+```
+
+## 🚀 Quick Start
+
+1. **Run the CLI**:
+   ```bash
+   godfather
+   ```
+
+2. **Authenticate**:
+   - Visit the admin portal to get your authentication token
+   - Paste the token when prompted
+
+3. **Connect to a Pod**:
+   - Select option `2` to connect to a pod
+   - Choose from available pods
+   - Automatically SSH into your isolated workspace
+
+## 📖 Usage
+
+### Interactive Menu
+
+Simply run:
+```bash
+godfather
+```
+
+You'll see a beautiful menu:
+```
+╔═══════════════════════════════════════╗
+║ Godfather CLI                         ║
+║ AI Society RunPod Environment Manager ║
+╚═══════════════════════════════════════╝
+
+╭──────── What would you like to do? ──────────╮
+│ 1.  📋 List available pods                   │
+│ 2.  🔌 Connect to a pod                      │
+│ 3.  📊 Show status                           │
+│ 4.  🚪 Logout                                │
+│ 5.  👋 Exit                                  │
+╰──────────────────────────────────────────────╯
+```
+
+### Command-Line Interface
+
+```bash
+# List available pods
+godfather list
+
+# Connect to a specific pod
+godfather connect <pod-id>
+
+# Connect interactively
+godfather connect
+
+# Show CLI status
+godfather status
+
+# Logout
+godfather logout
+
+# Re-authenticate
+godfather auth
+
+# Use custom API URL
+godfather --api-url https://your-api.com list
+```
+
+## 🔑 Authentication
+
+1. Get your authentication token from: `https://your-godfather-instance.com/cli-auth`
+2. Run `godfather` or `godfather auth`
+3. Paste your token when prompted
+4. Token is securely stored in `~/.godfather/config.json`
+
+## 🛠️ Configuration
+
+Configuration is stored in `~/.godfather/config.json`:
+
+```json
+{
+  "token": "discord_<user_id>_<timestamp>",
+  "discord_user_id": "<your_discord_id>"
+}
+```
+
+### Environment Variables
+
+You can override the API URL with:
+
+```bash
+export GODFATHER_API_URL="https://your-api.com"
+# or
+export BACKEND_URL="https://your-api.com"
+# or
+export NEXT_PUBLIC_BACKEND_URL="https://your-api.com"
+```
+
+## 🎨 Features in Detail
+
+### Beautiful Tables
+
+Pod listings display in rich, colorful tables:
+
+```
+           🚀 Available Pods (3)
+╭───┬────────┬─────────────┬──────────────┬───────────╮
+│ # │ Status │ Name        │ ID           │ Created   │
+├───┼────────┼─────────────┼──────────────┼───────────┤
+│ 1 │ 🟢 RUN │ ml-training │ abc123def... │ 2 days ago│
+│ 2 │ 🟢 RUN │ gpu-dev     │ xyz789ghi... │ 1 week ago│
+│ 3 │ 🔴 OFF │ testing     │ jkl456mno... │ 3 days ago│
+╰───┴────────┴─────────────┴──────────────┴───────────╯
+```
+
+### Status Dashboard
+
+```
+        Godfather CLI Status
+╭─────────────────────┬─────────────────────────────╮
+│ 🔐 Authentication   │ ✓ Authenticated             │
+│ 🌐 API Connection   │ ✓ Connected                 │
+│ 🏠 Config Directory │ /home/user/.godfather       │
+│ 🔗 API Endpoint     │ https://api.example.com     │
+╰─────────────────────┴─────────────────────────────╯
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+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.
+
+## 🆘 Support
+
+- **Issues**: [GitHub Issues](https://github.com/theaisocietyasu/godfather/issues)
+- **Discord**: Contact AI Society ASU administrators
+- **Email**: admin@ais-asu.com
+
+## 🎓 About
+
+Built with ❤️ by [AI Society at Arizona State University](https://github.com/theaisocietyasu)
+
+---
+
+**Note**: You need to be a member of the AI Society Discord server with appropriate permissions to use this CLI.

godfather_cli-1.0.1/godfather_cli/__init__.py

@@ -0,0 +1,7 @@
+"""
+Godfather CLI package
+"""
+
+__version__ = "1.0.0"
+__author__ = "AI Society ASU"
+__email__ = "admin@ais-asu.com"

godfather_cli-1.0.1/godfather_cli/auth.py

@@ -0,0 +1,135 @@
+"""CLI Authentication module"""
+import os
+import json
+import requests
+import getpass
+from pathlib import Path
+from typing import Dict, Optional
+from rich.console import Console
+from rich.panel import Panel
+from rich import box
+from rich.prompt import Prompt
+
+console = Console()
+
+
+class CLIAuthenticator:
+    """Handle CLI authentication"""
+    
+    def __init__(self, api_base: str, config_dir: Path):
+        self.api_base = api_base
+        self.config_dir = config_dir
+        self.config_file = config_dir / 'config.json'
+        self.config = self.load_config()
+    
+    def load_config(self) -> Dict:
+        """Load configuration from file"""
+        if self.config_file.exists():
+            try:
+                with open(self.config_file, 'r') as f:
+                    return json.load(f)
+            except (json.JSONDecodeError, IOError):
+                pass
+        return {}
+    
+    def save_config(self):
+        """Save configuration to file"""
+        self.config_dir.mkdir(exist_ok=True)
+        with open(self.config_file, 'w') as f:
+            json.dump(self.config, f, indent=2)
+    
+    def authenticate(self) -> bool:
+        """Authenticate user via CLI token"""
+        panel = Panel(
+            f"[cyan]Visit the admin portal to get your authentication token:[/cyan]\n"
+            f"[bold white]{self.api_base}/cli-auth[/bold white]",
+            title="[bold magenta]🔐 Authentication Required[/bold magenta]",
+            border_style="magenta",
+            box=box.ROUNDED
+        )
+        console.print(panel)
+        console.print()
+        
+        token = Prompt.ask("[cyan]Enter your authentication token[/cyan]", password=True).strip()
+        if not token:
+            console.print("[red]✗[/red] No token provided")
+            return False
+        
+        # Extract Discord ID from token (format: discord_<ID>_<timestamp>)
+        try:
+            if token.startswith('discord_'):
+                parts = token.split('_')
+                if len(parts) >= 2:
+                    discord_user_id = parts[1]
+                else:
+                    console.print("[red]✗[/red] Invalid token format")
+                    return False
+            else:
+                console.print("[red]✗[/red] Invalid token format")
+                return False
+        except:
+            console.print("[red]✗[/red] Invalid token format")
+            return False
+        
+        # Verify token with backend
+        try:
+            response = requests.post(
+                f'{self.api_base}/api/auth/verify',
+                json={'discord_user_id': discord_user_id},
+                timeout=10
+            )
+            
+            if response.status_code == 200:
+                self.config['token'] = token
+                self.config['discord_user_id'] = discord_user_id
+                self.save_config()
+                console.print("[green]✓[/green] Authentication successful!")
+                return True
+            else:
+                error = response.json().get('error', 'Authentication failed')
+                console.print(f"[red]✗[/red] Authentication failed: {error}")
+                return False
+                
+        except requests.RequestException as e:
+            console.print(f"[red]✗[/red] Connection error: {e}")
+            return False
+    
+    def get_token(self) -> Optional[str]:
+        """Get authentication token"""
+        return self.config.get('token')
+    
+    def get_discord_user_id(self) -> Optional[str]:
+        """Get Discord user ID"""
+        return self.config.get('discord_user_id')
+    
+    def is_authenticated(self) -> bool:
+        """Check if user is authenticated"""
+        return 'token' in self.config
+    
+    def logout(self):
+        """Clear authentication token"""
+        if 'token' in self.config:
+            del self.config['token']
+            self.save_config()
+            console.print("[green]✓[/green] Logged out successfully")
+        else:
+            console.print("[yellow]ℹ[/yellow] You were not logged in")
+    
+    def verify_token(self) -> bool:
+        """Verify current token is still valid"""
+        if not self.is_authenticated():
+            return False
+        
+        discord_user_id = self.config.get('discord_user_id')
+        if not discord_user_id:
+            return False
+        
+        try:
+            response = requests.post(
+                f'{self.api_base}/api/auth/verify',
+                json={'discord_user_id': discord_user_id},
+                timeout=5
+            )
+            return response.status_code == 200
+        except:
+            return False

godfather_cli-1.0.1/godfather_cli/cli.py

@@ -0,0 +1,237 @@
+#!/usr/bin/env python3
+"""
+AI Society Godfather CLI - Modular version
+Command line interface for connecting to RunPod environments
+"""
+
+import os
+import sys
+import argparse
+from pathlib import Path
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich import box
+from rich.prompt import Prompt, Confirm
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+from .auth import CLIAuthenticator
+from .pod_manager import PodManager
+from .ssh_connector import SSHConnector
+
+console = Console()
+
+
+class GodfatherCLI:
+    """Main CLI application"""
+    
+    def __init__(self):
+        self.config_dir = Path.home() / '.godfather'
+        
+        # Auto-detect API URL from multiple possible environment variables
+        # Priority: GODFATHER_API_URL > BACKEND_URL > NEXT_PUBLIC_BACKEND_URL > NEXT_PUBLIC_API_URL
+        self.api_base = (
+            os.getenv('GODFATHER_API_URL') or 
+            os.getenv('BACKEND_URL') or 
+            os.getenv('NEXT_PUBLIC_BACKEND_URL') or 
+            (os.getenv('NEXT_PUBLIC_API_URL', '').replace('/api', '')) or
+            'https://8bzhwve1ri5cw2-80.proxy.runpod.net'  # Fallback to RunPod proxy
+        )
+        
+        # Initialize components
+        self.authenticator = CLIAuthenticator(self.api_base, self.config_dir)
+        self.pod_manager = PodManager(self.api_base)
+        self.ssh_connector = SSHConnector(self.api_base, self.config_dir)
+    
+    def print_banner(self):
+        """Print CLI banner"""
+        banner = Panel.fit(
+            "[bold magenta]Godfather CLI[/bold magenta]\n"
+            "[dim]AI Society RunPod Environment Manager[/dim]",
+            border_style="magenta",
+            box=box.DOUBLE
+        )
+        console.print(banner)
+        console.print()
+    
+    def ensure_authenticated(self) -> bool:
+        """Ensure user is authenticated"""
+        if not self.authenticator.is_authenticated():
+            return self.authenticator.authenticate()
+        
+        # Verify token is still valid
+        if not self.authenticator.verify_token():
+            console.print("[yellow]⚠[/yellow]  Token expired. Please re-authenticate.")
+            return self.authenticator.authenticate()
+        
+        return True
+    
+    def list_pods(self):
+        """List available public pods"""
+        if not self.ensure_authenticated():
+            return
+        
+        discord_user_id = self.authenticator.get_discord_user_id()
+        self.pod_manager.list_pods(discord_user_id)
+    
+    def connect_to_pod(self, pod_id: str = None):
+        """Connect to a specific pod"""
+        if not self.ensure_authenticated():
+            return
+        
+        discord_user_id = self.authenticator.get_discord_user_id()
+        
+        # Select pod if not provided
+        if not pod_id:
+            pod_id = self.pod_manager.select_pod(discord_user_id)
+            if not pod_id:
+                return
+        
+        console.print(f"[cyan]🔌 Connecting to pod {pod_id[:8]}...[/cyan]")
+        
+        # Get connection details
+        ssh_info = self.pod_manager.get_connection_info(pod_id, discord_user_id)
+        if not ssh_info:
+            return
+        
+        # Fetch SSH key
+        if not self.ssh_connector.fetch_ssh_key(discord_user_id):
+            return
+        
+        # Establish SSH connection
+        self.ssh_connector.connect(ssh_info)
+    
+    def status(self):
+        """Show CLI status and configuration"""
+        table = Table(title="[bold cyan]Godfather CLI Status[/bold cyan]", box=box.ROUNDED, border_style="cyan")
+        table.add_column("Setting", style="cyan bold", no_wrap=True)
+        table.add_column("Value", style="white")
+        
+        if self.authenticator.is_authenticated():
+            table.add_row("🔐 Authentication", "[green]✓ Authenticated[/green]")
+            if self.authenticator.verify_token():
+                table.add_row("🌐 API Connection", "[green]✓ Connected[/green]")
+            else:
+                table.add_row("🌐 API Connection", "[yellow]⚠ Token expired[/yellow]")
+        else:
+            table.add_row("🔐 Authentication", "[red]✗ Not authenticated[/red]")
+        
+        table.add_row("🏠 Config Directory", str(self.config_dir))
+        table.add_row("🔗 API Endpoint", self.api_base)
+        
+        console.print(table)
+    
+    def logout(self):
+        """Clear authentication token"""
+        self.authenticator.logout()
+    
+    def authenticate(self):
+        """Trigger authentication"""
+        self.authenticator.authenticate()
+    
+    def interactive_menu(self):
+        """Show interactive menu"""
+        self.print_banner()
+        
+        while True:
+            console.print()
+            menu = Table.grid(padding=(0, 2))
+            menu.add_column(style="cyan bold", justify="right")
+            menu.add_column(style="white")
+            
+            menu.add_row("1.", "📋 List available pods")
+            menu.add_row("2.", "🔌 Connect to a pod")
+            menu.add_row("3.", "📊 Show status")
+            menu.add_row("4.", "🚪 Logout")
+            menu.add_row("5.", "👋 Exit")
+            
+            panel = Panel(
+                menu,
+                title="[bold cyan]What would you like to do?[/bold cyan]",
+                border_style="cyan",
+                box=box.ROUNDED
+            )
+            console.print(panel)
+            
+            try:
+                choice = Prompt.ask("\n[cyan]Enter your choice[/cyan]", choices=["1", "2", "3", "4", "5"], default="1")
+                console.print()
+                
+                if choice == '1':
+                    self.list_pods()
+                elif choice == '2':
+                    self.connect_to_pod()
+                elif choice == '3':
+                    self.status()
+                elif choice == '4':
+                    self.logout()
+                elif choice == '5':
+                    console.print("[bold magenta]👋 Goodbye![/bold magenta]")
+                    break
+                    
+            except KeyboardInterrupt:
+                console.print("\n[bold magenta]👋 Goodbye![/bold magenta]")
+                break
+
+
+def main():
+    """Main CLI entry point"""
+    parser = argparse.ArgumentParser(
+        description='AI Society Godfather CLI - RunPod Environment Manager',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  godfather list                    # List available pods
+  godfather connect                 # Interactive pod connection
+  godfather connect <pod-id>        # Connect to specific pod
+  godfather status                  # Show CLI status
+  godfather logout                  # Clear authentication
+
+For support, contact AI Society administrators.
+        """
+    )
+    
+    parser.add_argument(
+        'command',
+        nargs='?',
+        choices=['list', 'connect', 'status', 'logout', 'auth'],
+        help='Command to execute'
+    )
+    parser.add_argument(
+        'pod_id',
+        nargs='?',
+        help='Pod ID for connect command'
+    )
+    parser.add_argument(
+        '--api-url',
+        help='Override API base URL'
+    )
+    
+    args = parser.parse_args()
+    
+    # Override API URL if provided
+    if args.api_url:
+        os.environ['GODFATHER_API_URL'] = args.api_url
+    
+    cli = GodfatherCLI()
+    
+    # If no command provided, show interactive menu
+    if not args.command:
+        cli.interactive_menu()
+        return
+    
+    # Execute command
+    if args.command == 'list':
+        cli.list_pods()
+    elif args.command == 'connect':
+        cli.connect_to_pod(args.pod_id)
+    elif args.command == 'status':
+        cli.status()
+    elif args.command == 'logout':
+        cli.logout()
+    elif args.command == 'auth':
+        cli.authenticate()
+
+
+if __name__ == '__main__':
+    main()

godfather_cli-1.0.1/godfather_cli/pod_manager.py

@@ -0,0 +1,132 @@
+"""CLI Pod Operations module"""
+import requests
+from typing import List, Dict, Optional
+from rich.console import Console
+from rich.table import Table
+from rich import box
+from rich.prompt import IntPrompt
+
+console = Console()
+
+
+class PodManager:
+    """Handle pod operations"""
+    
+    def __init__(self, api_base: str):
+        self.api_base = api_base
+    
+    def get_public_pods(self, discord_user_id: str) -> List[Dict]:
+        """Get list of public pods available for connection"""
+        try:
+            headers = {'X-Discord-User-ID': discord_user_id}
+            response = requests.get(
+                f'{self.api_base}/api/pods/public',
+                headers=headers,
+                timeout=10
+            )
+            
+            if response.status_code == 200:
+                return response.json().get('pods', [])
+            elif response.status_code == 401:
+                console.print("[red]✗[/red] Authentication failed. Please re-authenticate.")
+                return []
+            else:
+                error = response.json().get('error', 'Failed to fetch pods')
+                console.print(f"[red]✗[/red] Error: {error}")
+                return []
+                
+        except requests.RequestException as e:
+            console.print(f"[red]✗[/red] Connection error: {e}")
+            return []
+    
+    def get_connection_info(self, pod_id: str, discord_user_id: str) -> Optional[Dict]:
+        """Get SSH connection information for a pod"""
+        try:
+            headers = {'X-Discord-User-ID': discord_user_id}
+            response = requests.post(
+                f'{self.api_base}/api/pods/{pod_id}/connect',
+                headers=headers,
+                timeout=10
+            )
+            
+            if response.status_code == 200:
+                return response.json().get('ssh_info')
+            else:
+                error = response.json().get('error', 'Connection failed')
+                console.print(f"[red]✗[/red] Connection failed: {error}")
+                return None
+                
+        except requests.RequestException as e:
+            console.print(f"[red]✗[/red] Connection error: {e}")
+            return None
+    
+    def list_pods(self, discord_user_id: str):
+        """List available public pods"""
+        console.print("[cyan]📡 Fetching available pods...[/cyan]")
+        pods = self.get_public_pods(discord_user_id)
+        
+        if not pods:
+            console.print("[yellow]😔 No public pods available at the moment.[/yellow]")
+            console.print("   [dim]Ask a godfather to create and make pods public.[/dim]")
+            return
+        
+        table = Table(title=f"[bold cyan]🚀 Available Pods ({len(pods)})[/bold cyan]", box=box.ROUNDED, border_style="cyan")
+        table.add_column("#", style="dim", width=3)
+        table.add_column("Status", justify="center", width=8)
+        table.add_column("Name", style="cyan bold")
+        table.add_column("ID", style="dim")
+        table.add_column("Created", style="white")
+        
+        for i, pod in enumerate(pods, 1):
+            status = pod.get('status', 'Unknown')
+            if status == 'RUNNING':
+                status_display = "[green]� RUN[/green]"
+            else:
+                status_display = "[red]🔴 OFF[/red]"
+            
+            table.add_row(
+                str(i),
+                status_display,
+                pod['name'],
+                pod['id'][:12] + "...",
+                pod.get('created_at', 'Unknown')
+            )
+        
+        console.print()
+        console.print(table)
+    
+    def select_pod(self, discord_user_id: str) -> Optional[str]:
+        """Interactive pod selection"""
+        pods = self.get_public_pods(discord_user_id)
+        
+        if not pods:
+            console.print("[yellow]😔 No public pods available.[/yellow]")
+            return None
+        
+        table = Table(title="[bold cyan]🚀 Select a Pod[/bold cyan]", box=box.SIMPLE, border_style="cyan")
+        table.add_column("#", style="cyan bold", width=3)
+        table.add_column("Status", justify="center", width=8)
+        table.add_column("Name", style="white")
+        table.add_column("ID", style="dim")
+        
+        for i, pod in enumerate(pods, 1):
+            status = pod.get('status', 'Unknown')
+            status_display = "[green]🟢 RUN[/green]" if status == 'RUNNING' else "[red]🔴 OFF[/red]"
+            
+            table.add_row(
+                str(i),
+                status_display,
+                pod['name'],
+                pod['id'][:12] + "..."
+            )
+        
+        console.print()
+        console.print(table)
+        console.print()
+        
+        try:
+            choice = IntPrompt.ask("[cyan]Select a pod number[/cyan]", choices=[str(i) for i in range(1, len(pods) + 1)])
+            return pods[choice - 1]['id']
+        except (KeyboardInterrupt, EOFError):
+            console.print("\n[yellow]Selection cancelled[/yellow]")
+            return None

godfather_cli-1.0.1/godfather_cli/ssh_connector.py

@@ -0,0 +1,145 @@
+"""CLI SSH Connection module"""
+import os
+import subprocess
+import requests
+from pathlib import Path
+from typing import Dict, Optional
+
+
+class SSHConnector:
+    """Handle SSH connections to pods"""
+    
+    def __init__(self, api_base: str, config_dir: Path):
+        self.api_base = api_base
+        self.ssh_key_dir = config_dir / 'ssh'
+        self.ssh_key_file = self.ssh_key_dir / 'godfather_key'
+    
+    def fetch_ssh_key(self, discord_user_id: str) -> bool:
+        """Fetch SSH private key from API and save it"""
+        print("🔑 Fetching SSH key...")
+        try:
+            headers = {'X-Discord-User-ID': discord_user_id}
+            response = requests.get(
+                f'{self.api_base}/api/ssh-key',
+                headers=headers,
+                timeout=10
+            )
+            
+            if response.status_code != 200:
+                error = response.json().get('error', 'Unknown error')
+                print(f"❌ Failed to fetch SSH key: {error}")
+                return False
+            
+            private_key = response.json().get('private_key')
+            if not private_key:
+                print("❌ No SSH key returned from API")
+                return False
+            
+            # Ensure proper formatting
+            if '\\n' in private_key:
+                private_key = private_key.replace('\\n', '\n')
+            
+            if not private_key.endswith('\n'):
+                private_key += '\n'
+            
+            # Save SSH key
+            self.ssh_key_dir.mkdir(exist_ok=True)
+            
+            with open(self.ssh_key_file, 'w') as f:
+                f.write(private_key)
+            
+            # Set correct permissions
+            os.chmod(self.ssh_key_file, 0o600)
+            print("✅ SSH key ready")
+            
+            return True
+            
+        except requests.RequestException as e:
+            print(f"❌ Failed to fetch SSH key: {e}")
+            return False
+        except IOError as e:
+            print(f"❌ Failed to save SSH key: {e}")
+            return False
+    
+    def connect(self, ssh_info: Dict) -> int:
+        """Establish SSH connection to pod"""
+        host = ssh_info.get('host')
+        port = ssh_info.get('port', 22)
+        username = ssh_info.get('username', 'root')
+        user_folder = ssh_info.get('user_folder', 'user')
+        is_admin = ssh_info.get('is_admin', False)
+        
+        if not host:
+            print("❌ No host information available")
+            return 1
+        
+        print(f"🔗 Connecting to {host}:{port}")
+        print(f"👤 User workspace: /workspace/users/{user_folder}")
+        
+        if is_admin:
+            print("👑 Admin mode: Full system access")
+        else:
+            print("🔒 Restricted mode: Limited to your workspace")
+        
+        print("\n📁 Setting up your personal workspace...")
+        
+        # Setup user workspace
+        admin_flag = "true" if is_admin else "false"
+        setup_command = f"/usr/local/bin/godfather-user-setup.sh {user_folder} {admin_flag}"
+        
+        # Build SSH connection command
+        ssh_command = [
+            'ssh',
+            '-t',
+            '-i', str(self.ssh_key_file),
+            '-o', 'StrictHostKeyChecking=no',
+            '-o', 'UserKnownHostsFile=/dev/null',
+            '-p', str(port),
+            f'{username}@{host}',
+            f'PROFILE=$({setup_command}) && source $PROFILE && exec bash'
+        ]
+        
+        try:
+            print("🚪 Opening SSH session...")
+            
+            if is_admin:
+                print("✅ You have full admin access (sudo available)")
+            else:
+                print("💡 You're in your personal workspace")
+                print("🤝 You can also access /workspace/shared for collaboration")
+                print("⚠️  Restricted mode: No sudo access")
+            
+            print("📝 Type 'exit' to disconnect\n")
+            
+            # Execute SSH connection
+            result = subprocess.run(ssh_command)
+            
+            if result.returncode != 0:
+                print("\n❌ SSH connection failed!")
+                print("\n⚠️  SSH Key Setup Required")
+                print("=" * 60)
+                print("The pod needs to have the SSH key configured first.")
+                print("\nOption 1: Use the godfather-base Docker image (recommended)")
+                print("  - The image automatically sets up SSH on startup")
+                print("  - Image: theaisocietyasu/godfather-base:latest")
+                print("\nOption 2: Manual setup in RunPod web terminal:")
+                print("\n  mkdir -p /root/.ssh && \\")
+                print(f'  echo "$GODFATHER_SSH_PUBLIC_KEY" >> /root/.ssh/authorized_keys && \\')
+                print("  chmod 700 /root/.ssh && \\")
+                print("  chmod 600 /root/.ssh/authorized_keys")
+                print("\n💡 The GODFATHER_SSH_PUBLIC_KEY environment variable is already set in your pod.")
+                print("=" * 60)
+                return result.returncode
+            else:
+                print("\n👋 Disconnected from pod")
+                return 0
+            
+        except KeyboardInterrupt:
+            print("\n👋 Connection cancelled")
+            return 1
+        except FileNotFoundError:
+            print("❌ SSH client not found. Please install OpenSSH client.")
+            return 1
+        except subprocess.SubprocessError as e:
+            print(f"❌ SSH connection failed: {e}")
+            return 1

godfather_cli-1.0.1/godfather_cli.egg-info/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: godfather-cli
+Version: 1.0.1
+Summary: AI Society Godfather CLI - RunPod Environment Manager
+Author-email: AI Society ASU <theaisocietyasu@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/theaisocietyasu/godfather
+Project-URL: Repository, https://github.com/theaisocietyasu/godfather
+Project-URL: Issues, https://github.com/theaisocietyasu/godfather/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: rich>=13.0.0
+
+# Godfather CLI
+
+Beautiful command-line interface for managing AI Society ASU RunPod environments.
+
+![CLI Demo](https://img.shields.io/badge/python-3.7+-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+
+## ✨ Features
+
+- 🎨 **Beautiful Interface** - Rich terminal UI with colors, tables, and panels
+- 🔐 **Secure Authentication** - Discord-based authentication
+- 🚀 **Pod Management** - List and connect to available RunPod environments
+- 🔌 **SSH Integration** - Automatic SSH key setup and connection
+- 📊 **Status Monitoring** - Check authentication and configuration status
+
+## 📦 Installation
+
+### Option 1: Install from PyPI (Recommended)
+
+```bash
+pip install godfather-cli
+```
+
+### Option 2: Install from GitHub
+
+```bash
+pip install git+https://github.com/theaisocietyasu/godfather.git#subdirectory=cli
+```
+
+### Option 3: Install for Development
+
+```bash
+git clone https://github.com/theaisocietyasu/godfather.git
+cd godfather/cli
+pip install -e .
+```
+
+## 🚀 Quick Start
+
+1. **Run the CLI**:
+   ```bash
+   godfather
+   ```
+
+2. **Authenticate**:
+   - Visit the admin portal to get your authentication token
+   - Paste the token when prompted
+
+3. **Connect to a Pod**:
+   - Select option `2` to connect to a pod
+   - Choose from available pods
+   - Automatically SSH into your isolated workspace
+
+## 📖 Usage
+
+### Interactive Menu
+
+Simply run:
+```bash
+godfather
+```
+
+You'll see a beautiful menu:
+```
+╔═══════════════════════════════════════╗
+║ Godfather CLI                         ║
+║ AI Society RunPod Environment Manager ║
+╚═══════════════════════════════════════╝
+
+╭──────── What would you like to do? ──────────╮
+│ 1.  📋 List available pods                   │
+│ 2.  🔌 Connect to a pod                      │
+│ 3.  📊 Show status                           │
+│ 4.  🚪 Logout                                │
+│ 5.  👋 Exit                                  │
+╰──────────────────────────────────────────────╯
+```
+
+### Command-Line Interface
+
+```bash
+# List available pods
+godfather list
+
+# Connect to a specific pod
+godfather connect <pod-id>
+
+# Connect interactively
+godfather connect
+
+# Show CLI status
+godfather status
+
+# Logout
+godfather logout
+
+# Re-authenticate
+godfather auth
+
+# Use custom API URL
+godfather --api-url https://your-api.com list
+```
+
+## 🔑 Authentication
+
+1. Get your authentication token from: `https://your-godfather-instance.com/cli-auth`
+2. Run `godfather` or `godfather auth`
+3. Paste your token when prompted
+4. Token is securely stored in `~/.godfather/config.json`
+
+## 🛠️ Configuration
+
+Configuration is stored in `~/.godfather/config.json`:
+
+```json
+{
+  "token": "discord_<user_id>_<timestamp>",
+  "discord_user_id": "<your_discord_id>"
+}
+```
+
+### Environment Variables
+
+You can override the API URL with:
+
+```bash
+export GODFATHER_API_URL="https://your-api.com"
+# or
+export BACKEND_URL="https://your-api.com"
+# or
+export NEXT_PUBLIC_BACKEND_URL="https://your-api.com"
+```
+
+## 🎨 Features in Detail
+
+### Beautiful Tables
+
+Pod listings display in rich, colorful tables:
+
+```
+           🚀 Available Pods (3)
+╭───┬────────┬─────────────┬──────────────┬───────────╮
+│ # │ Status │ Name        │ ID           │ Created   │
+├───┼────────┼─────────────┼──────────────┼───────────┤
+│ 1 │ 🟢 RUN │ ml-training │ abc123def... │ 2 days ago│
+│ 2 │ 🟢 RUN │ gpu-dev     │ xyz789ghi... │ 1 week ago│
+│ 3 │ 🔴 OFF │ testing     │ jkl456mno... │ 3 days ago│
+╰───┴────────┴─────────────┴──────────────┴───────────╯
+```
+
+### Status Dashboard
+
+```
+        Godfather CLI Status
+╭─────────────────────┬─────────────────────────────╮
+│ 🔐 Authentication   │ ✓ Authenticated             │
+│ 🌐 API Connection   │ ✓ Connected                 │
+│ 🏠 Config Directory │ /home/user/.godfather       │
+│ 🔗 API Endpoint     │ https://api.example.com     │
+╰─────────────────────┴─────────────────────────────╯
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+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.
+
+## 🆘 Support
+
+- **Issues**: [GitHub Issues](https://github.com/theaisocietyasu/godfather/issues)
+- **Discord**: Contact AI Society ASU administrators
+- **Email**: admin@ais-asu.com
+
+## 🎓 About
+
+Built with ❤️ by [AI Society at Arizona State University](https://github.com/theaisocietyasu)
+
+---
+
+**Note**: You need to be a member of the AI Society Discord server with appropriate permissions to use this CLI.

godfather_cli-1.0.1/godfather_cli.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+MANIFEST.in
+README.md
+pyproject.toml
+godfather_cli/__init__.py
+godfather_cli/auth.py
+godfather_cli/cli.py
+godfather_cli/pod_manager.py
+godfather_cli/ssh_connector.py
+godfather_cli.egg-info/PKG-INFO
+godfather_cli.egg-info/SOURCES.txt
+godfather_cli.egg-info/dependency_links.txt
+godfather_cli.egg-info/entry_points.txt
+godfather_cli.egg-info/requires.txt
+godfather_cli.egg-info/top_level.txt

godfather_cli-1.0.1/godfather_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

godfather_cli-1.0.1/godfather_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+godfather = godfather_cli.cli:main

godfather_cli-1.0.1/godfather_cli.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests>=2.25.0
+rich>=13.0.0

godfather_cli-1.0.1/godfather_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+godfather_cli

godfather_cli-1.0.1/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "godfather-cli"
+version = "1.0.1"
+description = "AI Society Godfather CLI - RunPod Environment Manager"
+authors = [
+    {name = "AI Society ASU", email = "theaisocietyasu@gmail.com"}
+]
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+]
+dependencies = [
+    "requests>=2.25.0",
+    "rich>=13.0.0",
+]
+
+[project.scripts]
+godfather = "godfather_cli.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/theaisocietyasu/godfather"
+Repository = "https://github.com/theaisocietyasu/godfather"
+Issues = "https://github.com/theaisocietyasu/godfather/issues"

godfather_cli-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+