vspagent 2.2.0__tar.gz → 3.0.0__tar.gz

{vspagent-2.2.0 → vspagent-3.0.0}/LICENSE

@@ -1,22 +1,23 @@
-MIT License
-
-Copyright (c) 2023 Vishnu Suresh Perumbavoor
-
-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.
-
+MIT License
+
+Copyright (c) 2023 Vishnu Suresh Perumbavoor
+
+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.
+
+

vspagent-3.0.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.1
+Name: vspagent
+Version: 3.0.0
+Summary: Universal Google Colab MCP Engine & Remote Cloud GPU Orchestration SDK.
+Home-page: https://github.com/vishnusureshperumbavoor/vspagent
+Author: Vishnu Suresh Perumbavoor
+Project-URL: Bug Tracker, https://github.com/vishnusureshperumbavoor/vspagent/issues
+Project-URL: LinkedIn, https://www.linkedin.com/in/vishnu-suresh-perumbavoor/
+Project-URL: GitHub, https://github.com/vishnusureshperumbavoor
+Keywords: colab mcp model-context-protocol gpu fine-tuning cloud-execution ai-agent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: all
+Provides-Extra: fastapi
+Provides-Extra: flask
+License-File: LICENSE
+
+# ⚡ vspagent
+
+[![PyPI version](https://badge.fury.io/py/vspagent.svg)](https://pypi.org/project/vspagent/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/vspagent.svg)](https://pypi.org/project/vspagent/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Universal Google Colab MCP Engine & Remote Cloud GPU Orchestration SDK.**
+
+`vspagent` gives any Python app, web server, or CLI instant access to free/pro Google Colab Cloud GPUs (Tesla T4, A100, V100) via the **Model Context Protocol (MCP)** with **zero local VRAM/GPU requirements**.
+
+---
+
+## 🌟 Key Features
+
+- 🔗 **Zero-Configuration Colab MCP Handshake**: Automatically manages the `colab-mcp` stdio subprocess and JSON-RPC lifecycle.
+- 👤 **Cross-Platform Chrome Profile Detection**: Detects all signed-in Google/Gmail accounts across Linux native, WSL, Windows, and macOS, opening pairing in the exact profile chosen.
+- 🚀 **Remote GPU Execution**: Programmatically injects, executes, polls, and deletes code cells on Google Colab with structured output and traceback handling.
+- 🔌 **Pre-Built Web Framework Adapters**:
+  - **FastAPI**: One-line `include_router(get_colab_router())` providing ready-to-use `/colab/status`, `/colab/accounts`, `/colab/connect`, `/colab/execute` endpoints.
+  - **Flask**: One-line `register_blueprint(get_colab_blueprint())` supporting synchronous multi-threaded Flask servers.
+- 🖥️ **Built-in CLI**: Interactive terminal utility with live account discovery, status dashboards, and code execution.
+- 🪶 **Ultra-Lightweight**: Zero local PyTorch, CUDA, or transformers dependencies. Local package size is under 1MB.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install vspagent
+```
+
+For web framework support:
+```bash
+# With FastAPI support
+pip install "vspagent[fastapi]"
+
+# With Flask support
+pip install "vspagent[flask]"
+
+# With all integrations
+pip install "vspagent[all]"
+```
+
+---
+
+## 🛠️ Quickstart
+
+### 1. Python SDK
+
+```python
+import asyncio
+from vspagent import ColabClient
+
+async def main():
+    colab = ColabClient()
+    
+    # Connect with preferred Chrome profile (or Default)
+    print("Connecting to Google Colab...")
+    await colab.connect_browser(profile_directory="Default")
+    
+    # Wait until user approves pairing in Chrome tab
+    await colab.ensure_connected(timeout=60.0)
+    print(f"Connected! GPU: {colab.gpu_info}")
+    
+    # Execute code on remote cloud GPU
+    code = """
+import torch
+print("Hello from Colab GPU:", torch.cuda.get_device_name(0))
+    """
+    res = await colab.execute_code(code, keep_cell=False)
+    print("Output:\n", res["output"])
+
+asyncio.run(main())
+```
+
+---
+
+### 2. FastAPI Web Integration (e.g. Vibe-ML-Studio, Vibe-MI-Stdio)
+
+Mount the pre-built router directly onto your FastAPI application:
+
+```python
+from fastapi import FastAPI
+from vspagent.colab.integrations import get_colab_router
+
+app = FastAPI(title="My GPU-Accelerated Service")
+
+# Mounts /colab/status, /colab/accounts, /colab/connect, /colab/execute
+app.include_router(get_colab_router(), prefix="/api")
+```
+
+---
+
+### 3. Flask Web Integration (e.g. Karaoke Extractor)
+
+```python
+from flask import Flask
+from vspagent.colab.integrations import get_colab_blueprint
+
+app = Flask(__name__)
+
+# Mounts /colab/status, /colab/accounts, /colab/connect, /colab/execute
+app.register_blueprint(get_colab_blueprint(), url_prefix="/api/colab")
+```
+
+---
+
+### 4. Interactive Terminal CLI
+
+```bash
+# 1. Discover available Google / Chrome accounts
+vspagent colab accounts
+
+# 2. Check connection status and GPU hardware
+vspagent colab status
+
+# 3. Interactively connect to Colab tab
+vspagent colab connect
+
+# 4. Execute Python code directly on remote Colab GPU
+vspagent colab exec -c "import torch; print(torch.cuda.is_available())"
+
+# Or run a complete Python script file
+vspagent colab exec -f ./train_decision_model.py
+```
+
+---
+
+## 📄 License
+
+MIT License © [Vishnu Suresh Perumbavoor](https://github.com/vishnusureshperumbavoor)

vspagent-3.0.0/README.md

@@ -0,0 +1,131 @@
+# ⚡ vspagent
+
+[![PyPI version](https://badge.fury.io/py/vspagent.svg)](https://pypi.org/project/vspagent/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/vspagent.svg)](https://pypi.org/project/vspagent/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Universal Google Colab MCP Engine & Remote Cloud GPU Orchestration SDK.**
+
+`vspagent` gives any Python app, web server, or CLI instant access to free/pro Google Colab Cloud GPUs (Tesla T4, A100, V100) via the **Model Context Protocol (MCP)** with **zero local VRAM/GPU requirements**.
+
+---
+
+## 🌟 Key Features
+
+- 🔗 **Zero-Configuration Colab MCP Handshake**: Automatically manages the `colab-mcp` stdio subprocess and JSON-RPC lifecycle.
+- 👤 **Cross-Platform Chrome Profile Detection**: Detects all signed-in Google/Gmail accounts across Linux native, WSL, Windows, and macOS, opening pairing in the exact profile chosen.
+- 🚀 **Remote GPU Execution**: Programmatically injects, executes, polls, and deletes code cells on Google Colab with structured output and traceback handling.
+- 🔌 **Pre-Built Web Framework Adapters**:
+  - **FastAPI**: One-line `include_router(get_colab_router())` providing ready-to-use `/colab/status`, `/colab/accounts`, `/colab/connect`, `/colab/execute` endpoints.
+  - **Flask**: One-line `register_blueprint(get_colab_blueprint())` supporting synchronous multi-threaded Flask servers.
+- 🖥️ **Built-in CLI**: Interactive terminal utility with live account discovery, status dashboards, and code execution.
+- 🪶 **Ultra-Lightweight**: Zero local PyTorch, CUDA, or transformers dependencies. Local package size is under 1MB.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install vspagent
+```
+
+For web framework support:
+```bash
+# With FastAPI support
+pip install "vspagent[fastapi]"
+
+# With Flask support
+pip install "vspagent[flask]"
+
+# With all integrations
+pip install "vspagent[all]"
+```
+
+---
+
+## 🛠️ Quickstart
+
+### 1. Python SDK
+
+```python
+import asyncio
+from vspagent import ColabClient
+
+async def main():
+    colab = ColabClient()
+    
+    # Connect with preferred Chrome profile (or Default)
+    print("Connecting to Google Colab...")
+    await colab.connect_browser(profile_directory="Default")
+    
+    # Wait until user approves pairing in Chrome tab
+    await colab.ensure_connected(timeout=60.0)
+    print(f"Connected! GPU: {colab.gpu_info}")
+    
+    # Execute code on remote cloud GPU
+    code = """
+import torch
+print("Hello from Colab GPU:", torch.cuda.get_device_name(0))
+    """
+    res = await colab.execute_code(code, keep_cell=False)
+    print("Output:\n", res["output"])
+
+asyncio.run(main())
+```
+
+---
+
+### 2. FastAPI Web Integration (e.g. Vibe-ML-Studio, Vibe-MI-Stdio)
+
+Mount the pre-built router directly onto your FastAPI application:
+
+```python
+from fastapi import FastAPI
+from vspagent.colab.integrations import get_colab_router
+
+app = FastAPI(title="My GPU-Accelerated Service")
+
+# Mounts /colab/status, /colab/accounts, /colab/connect, /colab/execute
+app.include_router(get_colab_router(), prefix="/api")
+```
+
+---
+
+### 3. Flask Web Integration (e.g. Karaoke Extractor)
+
+```python
+from flask import Flask
+from vspagent.colab.integrations import get_colab_blueprint
+
+app = Flask(__name__)
+
+# Mounts /colab/status, /colab/accounts, /colab/connect, /colab/execute
+app.register_blueprint(get_colab_blueprint(), url_prefix="/api/colab")
+```
+
+---
+
+### 4. Interactive Terminal CLI
+
+```bash
+# 1. Discover available Google / Chrome accounts
+vspagent colab accounts
+
+# 2. Check connection status and GPU hardware
+vspagent colab status
+
+# 3. Interactively connect to Colab tab
+vspagent colab connect
+
+# 4. Execute Python code directly on remote Colab GPU
+vspagent colab exec -c "import torch; print(torch.cuda.is_available())"
+
+# Or run a complete Python script file
+vspagent colab exec -f ./train_decision_model.py
+```
+
+---
+
+## 📄 License
+
+MIT License © [Vishnu Suresh Perumbavoor](https://github.com/vishnusureshperumbavoor)

{vspagent-2.2.0 → vspagent-3.0.0}/setup.cfg

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

{vspagent-2.2.0 → vspagent-3.0.0}/setup.py

@@ -1,45 +1,49 @@
-from setuptools import setup, find_packages
-
-with open("README.md", "r", encoding="utf-8") as fh:
-    long_description = fh.read()
-
-setup(
-    name="vspagent",
-    version="2.2.0",
-    author="Vishnu Suresh Perumbavoor",
-    author_email="vishnusureshperumbavoor@gmail.com",
-    description="AI-powered chat agent about Vishnu Suresh Perumbavoor. Powered by Qwen2.5-0.5B.",
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    url="https://github.com/vishnusureshperumbavoor/vsp_bot",
-    project_urls={
-        "Bug Tracker": "https://github.com/vishnusureshperumbavoor/vsp_bot/issues",
-        "LinkedIn": "https://www.linkedin.com/in/vishnu-suresh-perumbavoor/",
-        "GitHub": "https://github.com/vishnusureshperumbavoor",
-    },
-    classifiers=[
-        "Development Status :: 4 - Beta",
-        "Intended Audience :: Developers",
-        "Topic :: Scientific/Engineering :: Artificial Intelligence",
-        "License :: OSI Approved :: MIT License",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-    ],
-    packages=find_packages(),
-    python_requires=">=3.8",
-    install_requires=[
-        "transformers>=4.30.0",
-        "torch>=2.0.0",
-    ],
-    entry_points={
-        "console_scripts": [
-            "vspagent-py=vspagent.cli:main",
-            # Alternative: "pyvspagent=vspagent.cli:main",
-        ],
-    },
-    keywords="ai agent chatbot qwen llm vsp transformers",
-)
-
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="vspagent",
+    version="3.0.0",
+    author="Vishnu Suresh Perumbavoor",
+    description="Universal Google Colab MCP Engine & Remote Cloud GPU Orchestration SDK.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/vishnusureshperumbavoor/vspagent",
+    project_urls={
+        "Bug Tracker": "https://github.com/vishnusureshperumbavoor/vspagent/issues",
+        "LinkedIn": "https://www.linkedin.com/in/vishnu-suresh-perumbavoor/",
+        "GitHub": "https://github.com/vishnusureshperumbavoor",
+    },
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    packages=find_packages(),
+    python_requires=">=3.8",
+    install_requires=[
+        "pydantic>=1.10.0",
+        "rich>=12.0.0",
+    ],
+    extras_require={
+        "fastapi": ["fastapi>=0.100.0", "uvicorn>=0.20.0"],
+        "flask": ["flask>=2.0.0"],
+        "all": ["fastapi>=0.100.0", "uvicorn>=0.20.0", "flask>=2.0.0"],
+    },
+    entry_points={
+        "console_scripts": [
+            "vspagent=vspagent.cli:main",
+        ],
+    },
+    keywords="colab mcp model-context-protocol gpu fine-tuning cloud-execution ai-agent",
+)

vspagent-3.0.0/vspagent/__init__.py

@@ -0,0 +1,23 @@
+"""vspagent: Universal Google Colab MCP Engine & Remote Cloud GPU Orchestration SDK."""
+
+__version__ = "3.0.0"
+__author__ = "Vishnu Suresh Perumbavoor"
+
+from vspagent.colab.client import ColabClient, ColabMCPClient, internal_colab_client
+from vspagent.colab.profiles import (
+    list_chrome_accounts,
+    set_selected_profile,
+    get_selected_profile,
+    open_url_with_profile,
+)
+
+__all__ = [
+    "ColabClient",
+    "ColabMCPClient",
+    "internal_colab_client",
+    "list_chrome_accounts",
+    "set_selected_profile",
+    "get_selected_profile",
+    "open_url_with_profile",
+    "__version__",
+]