sunholo 0.140.10__py3-none-any.whl → 0.140.12__py3-none-any.whl

sunholo/agents/flask/vac_routes.py

@@ -6,10 +6,6 @@ import random
 from functools import partial
 import inspect
 import asyncio
-import time
-import threading
-from functools import lru_cache
-from concurrent.futures import ThreadPoolExecutor
 
 from ..chat_history import extract_chat_history_with_cache, extract_chat_history_async_cached
 from ...qna.parsers import parse_output
@@ -36,11 +32,6 @@ except ImportError:
 # Cache dictionary to store validated API keys
 api_key_cache = {}
 cache_duration = timedelta(minutes=5)  # Cache duration
-# Global caches and thread pool 
-_config_cache = {}
-_config_lock = threading.Lock()
-_thread_pool = ThreadPoolExecutor(max_workers=4)
-
 
 class VACRoutes:
     """
@@ -78,44 +69,8 @@ if __name__ == "__main__":
         self.additional_routes = additional_routes if additional_routes is not None else []
         self.async_stream = async_stream
         self.add_langfuse_eval = add_langfuse_eval
-
-        # Pre-warm common configs
-        self._preload_common_configs()   
-
         self.register_routes()
-
-    def _preload_common_configs(self):
-        """Pre-load commonly used configurations to cache"""
-        common_vector_names = ["aitana3"]  # Add your common vector names 
-        for vector_name in common_vector_names:
-            try:
-                self._get_cached_config(vector_name)
-                log.info(f"Pre-loaded config for {vector_name}")
-            except Exception as e:
-                log.warning(f"Failed to pre-load config for {vector_name}: {e}")
-
-    def _get_cached_config(self, vector_name: str):
-        """Cached config loader with thread safety - CORRECTED VERSION"""
-        # Check cache first (without lock for read)
-        if vector_name in _config_cache:
-            log.debug(f"Using cached config for {vector_name}")
-            return _config_cache[vector_name]
         
-        # Need to load config
-        with _config_lock:
-            # Double-check inside lock (another thread might have loaded it)
-            if vector_name in _config_cache:
-                return _config_cache[vector_name]
-            
-            try:
-                log.info(f"Loading fresh config for {vector_name}")
-                config = ConfigManager(vector_name)
-                _config_cache[vector_name] = config
-                log.info(f"Cached config for {vector_name}")
-                return config
-            except Exception as e:
-                log.error(f"Error loading config for {vector_name}: {e}")
-                raise
 
     def vac_interpreter_default(self, question: str, vector_name: str, chat_history=[], **kwargs):
         # Create a callback that does nothing for streaming if you don't want intermediate outputs
@@ -273,18 +228,7 @@ if __name__ == "__main__":
 
         log.info(f"OpenAI response: {openai_response}")
         return jsonify(openai_response)
-
-    def _finalize_trace_background(self, trace, span, response, all_input):
-        """Finalize trace operations in background"""
-        try:
-            if span:
-                span.end(output=str(response))
-            if trace:
-                trace.update(output=str(response))
-                self.langfuse_eval_response(trace_id=trace.id, eval_percent=all_input.get('eval_percent'))
-        except Exception as e:
-            log.warning(f"Background trace finalization failed: {e}")
-
+        
     def handle_stream_vac(self, vector_name):
         observed_stream_interpreter = self.stream_interpreter
         is_async = inspect.iscoroutinefunction(self.stream_interpreter)
@@ -710,131 +654,144 @@ if __name__ == "__main__":
             tags = tags,
             release = package_version
         )
-    
-    def _create_langfuse_trace_background(self, request, vector_name, trace_id):
-        """Create Langfuse trace in background"""
-        try:
-            return self.create_langfuse_trace(request, vector_name, trace_id)
-        except Exception as e:
-            log.warning(f"Background trace creation failed: {e}")
-            return None
 
-    def _handle_file_upload_background(self, file, vector_name):
-        """Handle file upload in background thread"""
-        try:
-            # Save with timestamp to avoid conflicts
-            temp_filename = f"temp_{int(time.time() * 1000)}_{file.filename}"
-            file.save(temp_filename)
-            
-            # Upload to GCS
-            image_uri = add_file_to_gcs(temp_filename, vector_name)
-            
-            # Clean up
-            os.remove(temp_filename)
-            
-            return {"image_uri": image_uri, "mime": file.mimetype}
-        except Exception as e:
-            log.error(f"Background file upload failed: {e}")
-            return {}
-    
     def prep_vac(self, request, vector_name):
-        start_time = time.time()
-        
-        # Fast request parsing - KEEP ORIGINAL ERROR HANDLING STYLE
+
         if request.content_type.startswith('application/json'):
             data = request.get_json()
         elif request.content_type.startswith('multipart/form-data'):
             data = request.form.to_dict()
-            # Handle file upload in background if present
             if 'file' in request.files:
                 file = request.files['file']
                 if file.filename != '':
-                    log.info(f"Found file: {file.filename} - uploading in background")
-                    # Start file upload in background, don't block
-                    upload_future = _thread_pool.submit(self._handle_file_upload_background, file, vector_name)
-                    data["_upload_future"] = upload_future
+                    log.info(f"Found file: {file.filename} to upload to GCS")
+                    try:
+                        image_uri, mime_type = self.handle_file_upload(file, vector_name)
+                        data["image_uri"] = image_uri
+                        data["mime"] = mime_type
+                    except Exception as e:
+                        log.error(traceback.format_exc())
+                        return jsonify({'error': str(e), 'traceback': traceback.format_exc()}), 500
+                else:
+                    log.error("No file selected")
+                    return jsonify({"error": "No file selected"}), 400
         else:
-            # KEEP ORIGINAL STYLE - return the error response directly
-            raise ValueError("Unsupported content type")
+            return jsonify({"error": "Unsupported content type"}), 400
 
-        log.info(f"vac/{vector_name} got data keys: {list(data.keys())}")
+        log.info(f"vac/{vector_name} got data: {data}")
 
-        # Get config from cache first (before processing other data)
+        trace = None
+        span = None
+        if self.add_langfuse_eval:
+            trace_id = data.get('trace_id')
+            trace = self.create_langfuse_trace(request, vector_name, trace_id)
+            log.info(f"Using existing langfuse trace: {trace_id}")
+        
+        #config, _ = load_config("config/llm_config.yaml")
         try:
-            vac_config = self._get_cached_config(vector_name)
+            vac_config = ConfigManager(vector_name)
         except Exception as e:
             raise ValueError(f"Unable to find vac_config for {vector_name} - {str(e)}")
 
-        # Extract data (keep original logic)
+        if trace:
+            this_vac_config = vac_config.configs_by_kind.get("vacConfig")
+            metadata_config=None
+            if this_vac_config:
+                metadata_config = this_vac_config.get(vector_name)
+
+            trace.update(input=data, metadata=metadata_config)
+
         user_input = data.pop('user_input').strip()
         stream_wait_time = data.pop('stream_wait_time', 7)
         stream_timeout = data.pop('stream_timeout', 120)
         chat_history = data.pop('chat_history', None)
         eval_percent = data.pop('eval_percent', 0.01)
-        vector_name_param = data.pop('vector_name', vector_name)
-        data.pop('trace_id', None)  # to ensure not in kwargs
+        vector_name = data.pop('vector_name', vector_name)
+        data.pop('trace_id', None) # to ensure not in kwargs
 
-        # Process chat history with caching
         paired_messages = extract_chat_history_with_cache(chat_history)
 
-        # Wait for file upload if it was started (with timeout)
-        if "_upload_future" in data:
-            try:
-                upload_result = data["_upload_future"].result(timeout=3.0)  # 3 sec max wait
-                data.update(upload_result)
-                log.info(f"File upload completed: {upload_result.get('image_uri', 'no uri')}")
-            except Exception as e:
-                log.warning(f"File upload failed or timed out: {e}")
-            finally:
-                data.pop("_upload_future", None)
+        all_input = {'user_input': user_input, 
+                     'vector_name': vector_name, 
+                     'chat_history': paired_messages, 
+                     'stream_wait_time': stream_wait_time,
+                     'stream_timeout': stream_timeout,
+                     'eval_percent': eval_percent,
+                     'kwargs': data}
+
+        if trace:
+            span = trace.span(
+                name="VAC",
+                metadata=vac_config.configs_by_kind,
+                input = all_input
+            )
+    
+        return {
+            "trace": trace,
+            "span": span,
+            "all_input": all_input,
+            "vac_config": vac_config
+        }
 
-        # BUILD all_input BEFORE trace creation (this was moved inside try/catch by mistake)
+    async def prep_vac_async(self, request, vector_name):
+        """Async version of prep_vac."""
+        # Parse request data
+        if request.content_type.startswith('application/json'):
+            data = request.get_json()
+        elif request.content_type.startswith('multipart/form-data'):
+            data = request.form.to_dict()
+            if 'file' in request.files:
+                file = request.files['file']
+                if file.filename != '':
+                    log.info(f"Found file: {file.filename} to upload to GCS")
+                    try:
+                        # Make file upload async if possible
+                        image_uri, mime_type = await self.handle_file_upload_async(file, vector_name)
+                        data["image_uri"] = image_uri
+                        data["mime"] = mime_type
+                    except Exception as e:
+                        log.error(traceback.format_exc())
+                        return jsonify({'error': str(e), 'traceback': traceback.format_exc()}), 500
+                else:
+                    log.error("No file selected")
+                    return jsonify({"error": "No file selected"}), 400
+        else:
+            return jsonify({"error": "Unsupported content type"}), 400
+
+        log.info(f"vac/{vector_name} got data: {data}")
+
+        # Run these operations concurrently
+        tasks = []
+        
+        # Extract other data while configs load
+        user_input = data.pop('user_input').strip()
+        stream_wait_time = data.pop('stream_wait_time', 7)
+        stream_timeout = data.pop('stream_timeout', 120)
+        chat_history = data.pop('chat_history', None)
+        vector_name_param = data.pop('vector_name', vector_name)
+        data.pop('trace_id', None)  # to ensure not in kwargs
+        
+        # Task 3: Process chat history
+        chat_history_task = asyncio.create_task(extract_chat_history_async_cached(chat_history))
+        tasks.append(chat_history_task)
+        
+        # Await all tasks concurrently
+        results = await asyncio.gather(*tasks, return_exceptions=True)
+
+        paired_messages = results[0] if not isinstance(results[0], Exception) else []
+        
+        # Only create span after we have trace
         all_input = {
             'user_input': user_input, 
             'vector_name': vector_name_param, 
             'chat_history': paired_messages, 
             'stream_wait_time': stream_wait_time,
             'stream_timeout': stream_timeout,
-            'eval_percent': eval_percent,
             'kwargs': data
         }
-
-        # Initialize trace variables
-        trace = None
-        span = None
-        if self.add_langfuse_eval:
-            trace_id = data.get('trace_id')
-            # Create trace in background - don't block
-            trace_future = _thread_pool.submit(self._create_langfuse_trace_background, request, vector_name, trace_id)
-
-            # Try to get trace result if available (don't block long)
-            try:
-                trace = trace_future.result(timeout=0.1)  # Very short timeout
-                if trace:
-                    this_vac_config = vac_config.configs_by_kind.get("vacConfig")
-                    metadata_config = None
-                    if this_vac_config:
-                        metadata_config = this_vac_config.get(vector_name)
-                    trace.update(input=data, metadata=metadata_config)
-                    
-                    span = trace.span(
-                        name="VAC",
-                        metadata=vac_config.configs_by_kind,
-                        input=all_input
-                    )
-            except Exception as e:
-                log.warning(f"Langfuse trace creation timed out or failed: {e}")
-                trace = None
-                span = None
-
-        prep_time = time.time() - start_time
-        log.info(f"prep_vac completed in {prep_time:.3f}s")
-
+        
         return {
-            "trace": trace,
-            "span": span,
-            "all_input": all_input,
-            "vac_config": vac_config
+            "all_input": all_input
         }
 
     def handle_file_upload(self, file, vector_name):
@@ -846,4 +803,3 @@ if __name__ == "__main__":
         except Exception as e:
             raise Exception(f'File upload failed: {str(e)}')
 
-

sunholo/utils/config_class.py

@@ -6,7 +6,38 @@ from collections import defaultdict
 from .timedelta import format_timedelta
 
 class ConfigManager:
-    def __init__(self, vector_name: str, validate:bool=True):
+    # Class-level cache for instances
+    _instances = {}
+    _instance_cache_time = {}
+    _instance_cache_duration = timedelta(minutes=30)  # Cache instances for 30 minutes
+    
+    def __new__(cls, vector_name: str, validate: bool = True):
+        """
+        Override __new__ to implement instance caching.
+        Returns existing instance if available and not expired.
+        """
+        current_time = datetime.now()
+        cache_key = (vector_name, validate)
+        
+        # Check if we have a cached instance
+        if cache_key in cls._instances:
+            cached_time = cls._instance_cache_time.get(cache_key)
+            if cached_time and (current_time - cached_time) < cls._instance_cache_duration:
+                # Return cached instance
+                return cls._instances[cache_key]
+            else:
+                # Cache expired, remove from cache
+                del cls._instances[cache_key]
+                if cache_key in cls._instance_cache_time:
+                    del cls._instance_cache_time[cache_key]
+        
+        # Create new instance
+        instance = super().__new__(cls)
+        cls._instances[cache_key] = instance
+        cls._instance_cache_time[cache_key] = current_time
+        return instance
+    
+    def __init__(self, vector_name: str, validate: bool = True):
         """
         Initialize the ConfigManager with a vector name.
         Requires a local config/ folder holding your configuration files or the env var VAC_CONFIG_FOLDER to be set.
@@ -24,6 +55,10 @@ class ConfigManager:
         agent = config.vacConfig("agent")
         ```
         """
+        # Prevent re-initialization of cached instances
+        if hasattr(self, '_initialized'):
+            return
+        
         if os.getenv("VAC_CONFIG_FOLDER") is None:
             print("WARNING: No VAC_CONFIG_FOLDER environment variable was specified")
         local_config_folder = os.path.join(os.getcwd(), "config")
@@ -39,11 +74,68 @@ class ConfigManager:
         self.local_config_folder = local_config_folder
         self.configs_by_kind = self.load_all_configs()
         self.validate = validate
+        self._initialized = True
 
         test_agent = self.vacConfig("agent")
         if not test_agent and self.vector_name != "global" and self.validate:
             print(f"WARNING: No vacConfig.agent found for {self.vector_name} - are you in right folder? {local_config_folder=} {self.config_folder=}")
 
+    @classmethod
+    def get_instance(cls, vector_name: str, validate: bool = True):
+        """
+        Alternative class method to get an instance. This is more explicit than using __new__.
+        
+        Args:
+            vector_name (str): The name of the vector in the configuration files.
+            validate (bool): Whether to validate the configurations
+            
+        Returns:
+            ConfigManager: The ConfigManager instance (cached or new)
+        """
+        return cls(vector_name, validate)
+    
+    @classmethod
+    def clear_instance_cache(cls, vector_name: str = None, validate: bool = None):
+        """
+        Clear the instance cache. Useful for forcing fresh instances.
+        
+        Args:
+            vector_name (str, optional): If provided, only clear cache for this vector_name
+            validate (bool, optional): If provided along with vector_name, clear specific cache entry
+        """
+        if vector_name is not None:
+            if validate is not None:
+                # Clear specific cache entry
+                cache_key = (vector_name, validate)
+                if cache_key in cls._instances:
+                    del cls._instances[cache_key]
+                if cache_key in cls._instance_cache_time:
+                    del cls._instance_cache_time[cache_key]
+            else:
+                # Clear all entries for this vector_name
+                keys_to_remove = [key for key in cls._instances.keys() if key[0] == vector_name]
+                for key in keys_to_remove:
+                    del cls._instances[key]
+                    if key in cls._instance_cache_time:
+                        del cls._instance_cache_time[key]
+        else:
+            # Clear all cache
+            cls._instances.clear()
+            cls._instance_cache_time.clear()
+    
+    @classmethod
+    def get_cached_instances(cls):
+        """
+        Get information about currently cached instances.
+        
+        Returns:
+            dict: Dictionary with cache keys and their creation times
+        """
+        return {
+            key: cls._instance_cache_time.get(key) 
+            for key in cls._instances.keys()
+        }
+
     def load_all_configs(self):
         """
         Load all configuration files from the specified directories into a dictionary.
@@ -251,4 +343,4 @@ class ConfigManager:
         if key in agents:
             return agents[key]
         else:
-            return None
+            return None

sunholo-0.140.12.dist-info/METADATA

@@ -0,0 +1,522 @@
+Metadata-Version: 2.4
+Name: sunholo
+Version: 0.140.12
+Summary: AI DevOps - a package to help deploy GenAI to the Cloud.
+Author-email: Holosun ApS <multivac@sunholo.com>
+License: Apache License, Version 2.0
+Project-URL: Homepage, https://github.com/sunholo-data/sunholo-py
+Project-URL: Download, https://github.com/sunholo-data/sunholo-py/archive/refs/tags/v0.118.0.tar.gz
+Keywords: llms,devops,google_cloud_platform
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: aiohttp
+Requires-Dist: google-auth
+Requires-Dist: ollama>=0.4.7
+Requires-Dist: pillow>=11.0.0
+Requires-Dist: pydantic
+Requires-Dist: requests
+Requires-Dist: ruamel.yaml
+Requires-Dist: tenacity
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Provides-Extra: all
+Requires-Dist: aiofiles; extra == "all"
+Requires-Dist: aiohttp; extra == "all"
+Requires-Dist: anthropic[vertex]; extra == "all"
+Requires-Dist: asyncpg; extra == "all"
+Requires-Dist: azure-identity; extra == "all"
+Requires-Dist: azure-storage-blob; extra == "all"
+Requires-Dist: fastapi; extra == "all"
+Requires-Dist: flask; extra == "all"
+Requires-Dist: google-auth; extra == "all"
+Requires-Dist: google-auth-httplib2; extra == "all"
+Requires-Dist: google-auth-oauthlib; extra == "all"
+Requires-Dist: google-cloud-aiplatform>=1.58.0; extra == "all"
+Requires-Dist: google-api-python-client; extra == "all"
+Requires-Dist: google-cloud-alloydb-connector[pg8000]; extra == "all"
+Requires-Dist: google-cloud-bigquery; extra == "all"
+Requires-Dist: google-cloud-build; extra == "all"
+Requires-Dist: google-cloud-service-control; extra == "all"
+Requires-Dist: google-cloud-logging; extra == "all"
+Requires-Dist: google-cloud-storage; extra == "all"
+Requires-Dist: google-cloud-pubsub; extra == "all"
+Requires-Dist: google-cloud-discoveryengine>=0.13.4; extra == "all"
+Requires-Dist: google-cloud-texttospeech; extra == "all"
+Requires-Dist: google-generativeai>=0.7.1; extra == "all"
+Requires-Dist: google-genai>=0.2.2; extra == "all"
+Requires-Dist: gunicorn; extra == "all"
+Requires-Dist: httpcore; extra == "all"
+Requires-Dist: httpx; extra == "all"
+Requires-Dist: jsonschema; extra == "all"
+Requires-Dist: lancedb; extra == "all"
+Requires-Dist: langchain>=0.2.16; extra == "all"
+Requires-Dist: langchain-experimental>=0.0.61; extra == "all"
+Requires-Dist: langchain-community>=0.2.11; extra == "all"
+Requires-Dist: langchain-openai>=0.3.2; extra == "all"
+Requires-Dist: langchain-google-genai>=2.0.9; extra == "all"
+Requires-Dist: langchain_google_alloydb_pg; extra == "all"
+Requires-Dist: langchain-anthropic>=0.1.23; extra == "all"
+Requires-Dist: langchain-google-vertexai; extra == "all"
+Requires-Dist: langchain-unstructured; extra == "all"
+Requires-Dist: langfuse; extra == "all"
+Requires-Dist: mcp; extra == "all"
+Requires-Dist: numpy; extra == "all"
+Requires-Dist: opencv-python; extra == "all"
+Requires-Dist: pg8000; extra == "all"
+Requires-Dist: pgvector; extra == "all"
+Requires-Dist: pillow; extra == "all"
+Requires-Dist: playwright; extra == "all"
+Requires-Dist: psutil; extra == "all"
+Requires-Dist: psycopg2-binary; extra == "all"
+Requires-Dist: pydantic; extra == "all"
+Requires-Dist: pypdf; extra == "all"
+Requires-Dist: python-hcl2; extra == "all"
+Requires-Dist: python-socketio; extra == "all"
+Requires-Dist: pytesseract; extra == "all"
+Requires-Dist: requests; extra == "all"
+Requires-Dist: rich; extra == "all"
+Requires-Dist: sounddevice; extra == "all"
+Requires-Dist: supabase; extra == "all"
+Requires-Dist: tabulate; extra == "all"
+Requires-Dist: tantivy; extra == "all"
+Requires-Dist: tenacity; extra == "all"
+Requires-Dist: tiktoken; extra == "all"
+Requires-Dist: unstructured[all-docs,local-inference]; extra == "all"
+Requires-Dist: xlwings; extra == "all"
+Provides-Extra: langchain
+Requires-Dist: langchain; extra == "langchain"
+Requires-Dist: langchain_experimental; extra == "langchain"
+Requires-Dist: langchain-community; extra == "langchain"
+Requires-Dist: langsmith; extra == "langchain"
+Requires-Dist: langchain-unstructured; extra == "langchain"
+Provides-Extra: azure
+Requires-Dist: azure-identity; extra == "azure"
+Requires-Dist: azure-storage-blob; extra == "azure"
+Provides-Extra: cli
+Requires-Dist: jsonschema>=4.21.1; extra == "cli"
+Requires-Dist: rich; extra == "cli"
+Provides-Extra: database
+Requires-Dist: asyncpg; extra == "database"
+Requires-Dist: supabase; extra == "database"
+Requires-Dist: sqlalchemy; extra == "database"
+Requires-Dist: pg8000; extra == "database"
+Requires-Dist: pgvector; extra == "database"
+Requires-Dist: psycopg2-binary; extra == "database"
+Requires-Dist: lancedb; extra == "database"
+Requires-Dist: tantivy; extra == "database"
+Provides-Extra: pipeline
+Requires-Dist: GitPython; extra == "pipeline"
+Requires-Dist: lark; extra == "pipeline"
+Requires-Dist: langchain>=0.2.16; extra == "pipeline"
+Requires-Dist: langchain-unstructured; extra == "pipeline"
+Requires-Dist: psutil; extra == "pipeline"
+Requires-Dist: pypdf; extra == "pipeline"
+Requires-Dist: pytesseract; extra == "pipeline"
+Requires-Dist: tabulate; extra == "pipeline"
+Requires-Dist: unstructured[all-docs,local-inference]; extra == "pipeline"
+Provides-Extra: gcp
+Requires-Dist: aiofiles; extra == "gcp"
+Requires-Dist: anthropic[vertex]; extra == "gcp"
+Requires-Dist: google-api-python-client; extra == "gcp"
+Requires-Dist: google-auth-httplib2; extra == "gcp"
+Requires-Dist: google-auth-oauthlib; extra == "gcp"
+Requires-Dist: google-cloud-alloydb-connector[pg8000]; extra == "gcp"
+Requires-Dist: google-cloud-aiplatform>=1.58.0; extra == "gcp"
+Requires-Dist: google-cloud-bigquery; extra == "gcp"
+Requires-Dist: google-cloud-build; extra == "gcp"
+Requires-Dist: google-cloud-service-control; extra == "gcp"
+Requires-Dist: google-cloud-storage; extra == "gcp"
+Requires-Dist: google-cloud-logging; extra == "gcp"
+Requires-Dist: google-cloud-pubsub; extra == "gcp"
+Requires-Dist: google-cloud-discoveryengine>=0.13.4; extra == "gcp"
+Requires-Dist: google-cloud-texttospeech; extra == "gcp"
+Requires-Dist: google-genai>=0.2.2; extra == "gcp"
+Requires-Dist: google-generativeai>=0.8.3; extra == "gcp"
+Requires-Dist: langchain; extra == "gcp"
+Requires-Dist: langchain-google-genai>=2.0.0; extra == "gcp"
+Requires-Dist: langchain_google_alloydb_pg>=0.2.2; extra == "gcp"
+Requires-Dist: langchain-google-vertexai; extra == "gcp"
+Requires-Dist: pillow; extra == "gcp"
+Provides-Extra: ollama
+Requires-Dist: pillow; extra == "ollama"
+Requires-Dist: ollama>=0.4.7; extra == "ollama"
+Provides-Extra: openai
+Requires-Dist: langchain-openai>=0.3.2; extra == "openai"
+Requires-Dist: tiktoken; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: langchain-anthropic>=0.1.23; extra == "anthropic"
+Requires-Dist: mcp; extra == "anthropic"
+Provides-Extra: tools
+Requires-Dist: openapi-spec-validator; extra == "tools"
+Requires-Dist: playwright; extra == "tools"
+Provides-Extra: http
+Requires-Dist: fastapi; extra == "http"
+Requires-Dist: flask; extra == "http"
+Requires-Dist: gunicorn; extra == "http"
+Requires-Dist: httpcore; extra == "http"
+Requires-Dist: httpx; extra == "http"
+Requires-Dist: langchain; extra == "http"
+Requires-Dist: langfuse; extra == "http"
+Requires-Dist: python-socketio; extra == "http"
+Requires-Dist: requests; extra == "http"
+Requires-Dist: tenacity; extra == "http"
+Provides-Extra: excel
+Requires-Dist: xlwings; extra == "excel"
+Requires-Dist: requests; extra == "excel"
+Requires-Dist: rich; extra == "excel"
+Provides-Extra: iac
+Requires-Dist: python-hcl2; extra == "iac"
+Provides-Extra: tts
+Requires-Dist: google-cloud-texttospeech; extra == "tts"
+Requires-Dist: numpy; extra == "tts"
+Requires-Dist: sounddevice; extra == "tts"
+Provides-Extra: video
+Requires-Dist: opencv-python; extra == "video"
+Dynamic: license-file
+
+# Sunholo Python Library
+
+[![PyPi Version](https://img.shields.io/pypi/v/sunholo.svg)](https://pypi.python.org/pypi/sunholo/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Python Version](https://img.shields.io/pypi/pyversions/sunholo.svg)](https://pypi.python.org/pypi/sunholo/)
+
+🚀 **AI DevOps framework for building GenAI applications on Google Cloud Platform**
+
+Sunholo is a comprehensive Python framework that streamlines the development, deployment, and management of Generative AI applications (VACs - Virtual Agent Computers). It provides a configuration-driven approach with deep integration into Google Cloud services while supporting multiple AI providers.
+
+## 🎯 What is Sunholo?
+
+Sunholo helps you:
+- 🤖 Build conversational AI agents with any LLM provider (Vertex AI, OpenAI, Anthropic, Ollama)
+- ☁️ Deploy to Google Cloud Run with automatic scaling
+- 🗄️ Use AlloyDB and Discovery Engine for vector storage and search
+- 🔄 Handle streaming responses and async processing
+- 📄 Process documents with chunking and embedding pipelines
+- 🔧 Manage complex configurations with YAML files
+- 🎨 Create APIs, web apps, and chat bots
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+Install [uv](https://docs.astral.sh/uv/) - a fast, modern Python package manager:
+
+```bash
+# macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### Installation
+
+```bash
+# Install with CLI tools (recommended)
+uv tool install --from "sunholo[cli]" sunholo
+
+# Install with all features including GCP
+uv tool install --from "sunholo[cli]" sunholo --with "sunholo[all]"
+```
+
+### Your First VAC
+
+1. **Initialize a new project:**
+```bash
+sunholo init my-ai-agent
+cd my-ai-agent
+```
+
+2. **Configure your AI agent:**
+Edit `config/vac_config.yaml`:
+```yaml
+kind: vacConfig
+apiVersion: v1
+vac:
+  my-agent:
+    llm: vertex
+    model: gemini-1.5-pro
+    agent: simple
+    description: "My AI agent powered by Google Cloud"
+```
+
+3. **Chat with your agent locally:**
+```bash
+sunholo vac chat my-agent
+```
+
+4. **Deploy to Google Cloud Run:**
+```bash
+sunholo deploy my-agent
+```
+
+## 📋 Features
+
+### Core Capabilities
+
+- **Multi-Model Support**: Integrate Vertex AI, OpenAI, Anthropic, Ollama in one app
+- **Document Processing**: Chunk, embed, and index documents with Discovery Engine
+- **Vector Databases**: Native support for AlloyDB, LanceDB, Supabase
+- **Streaming**: Real-time response streaming for chat applications
+- **Async Processing**: Pub/Sub integration for background tasks
+- **Authentication**: Built-in Google Cloud IAM and custom auth
+
+### Google Cloud Integration
+
+- **Vertex AI**: Access Gemini, PaLM, and custom models
+- **AlloyDB**: PostgreSQL-compatible vector database
+- **Discovery Engine**: Enterprise search and RAG
+- **Cloud Run**: Serverless deployment
+- **Cloud Storage**: Document and file management
+- **Pub/Sub**: Asynchronous message processing
+- **Cloud Logging**: Centralized logging
+
+### Framework Support
+
+- **Web Frameworks**: Flask and FastAPI templates
+- **AI Frameworks**: LangChain and LlamaIndex integration
+- **Observability**: Langfuse for tracing and monitoring
+- **API Standards**: OpenAI-compatible endpoints
+
+## 🛠 Installation Options
+
+### Using uv
+
+```bash
+# Core CLI features
+uv tool install --from "sunholo[cli]" sunholo
+
+# With Google Cloud Platform integration
+uv tool install --from "sunholo[cli]" sunholo --with "sunholo[gcp]"
+
+# With specific LLM providers
+uv tool install --from "sunholo[cli]" sunholo --with "sunholo[openai]"
+uv tool install --from "sunholo[cli]" sunholo --with "sunholo[anthropic]"
+
+# With database support
+uv tool install --from "sunholo[cli]" sunholo --with "sunholo[database]"
+
+# Everything
+uv tool install --from "sunholo[cli]" sunholo --with "sunholo[all]"
+```
+
+### Managing Installations
+
+```bash
+# Upgrade
+uv tool upgrade sunholo
+
+# List installed
+uv tool list
+
+# Uninstall
+uv tool uninstall sunholo
+```
+
+### Development Setup
+
+```bash
+# Clone repository
+git clone https://github.com/sunholo-data/sunholo-py.git
+cd sunholo-py
+
+# Install in development mode
+uv venv
+uv pip install -e ".[all]"
+
+# Run tests
+pytest tests/
+```
+
+## ⚙️ Configuration
+
+Sunholo uses YAML configuration files:
+
+```yaml
+# config/vac_config.yaml
+kind: vacConfig
+apiVersion: v1
+gcp_config:
+  project_id: my-gcp-project
+  location: us-central1
+vac:
+  my-agent:
+    llm: vertex
+    model: gemini-1.5-pro
+    agent: langchain
+    memory:
+      - alloydb:
+          project_id: my-gcp-project
+          region: us-central1
+          cluster: my-cluster
+          instance: my-instance
+    tools:
+      - search
+      - calculator
+```
+
+## 🔧 CLI Commands
+
+```bash
+# Project Management
+sunholo init <project-name>              # Create new project
+sunholo list-configs                     # List all configurations
+sunholo list-configs --validate          # Validate configs
+
+# Development
+sunholo vac chat <vac-name>             # Chat with a VAC locally
+sunholo vac list                        # List available VACs
+sunholo proxy start <service>           # Start local proxy to cloud service
+
+# Deployment
+sunholo deploy <vac-name>               # Deploy to Cloud Run
+sunholo deploy <vac-name> --dev         # Deploy to dev environment
+
+# Document Processing
+sunholo embed <vac-name>                # Embed documents
+sunholo merge-text <folder> <output>    # Merge files for context
+
+# Cloud Services
+sunholo discovery-engine create <name>   # Create Discovery Engine
+sunholo proxy list                      # List running proxies
+```
+
+## 📝 Examples
+
+### Vertex AI Chat with Memory
+
+```python
+from sunholo.utils import ConfigManager
+from sunholo.components import pick_llm
+from sunholo.agents import memory_client
+
+config = ConfigManager('my-agent')
+llm = pick_llm(config=config)
+memory = memory_client(config=config)
+
+# Chat with context
+response = llm.invoke("What is Google Cloud?")
+memory.add_message("user", "What is Google Cloud?")
+memory.add_message("assistant", response)
+```
+
+### Document Processing with Discovery Engine
+
+```python
+from sunholo.discovery_engine import DiscoveryEngineClient
+from sunholo.chunker import chunk_doc
+
+# Initialize client
+client = DiscoveryEngineClient(
+    project_id='my-project',
+    data_store_id='my-datastore'
+)
+
+# Process and index document
+chunks = chunk_doc.chunk_file("document.pdf", chunk_size=1000)
+client.import_documents(chunks)
+
+# Search
+results = client.search("What is the main topic?")
+```
+
+### Streaming Flask API
+
+```python
+from sunholo.agents import dispatch_to_qa
+
+@app.route('/vac/streaming/<vac_name>', methods=['POST'])
+def streaming_endpoint(vac_name):
+    question = request.json.get('user_input')
+    
+    def generate():
+        for chunk in dispatch_to_qa(
+            question, 
+            vac_name=vac_name,
+            stream=True
+        ):
+            yield f"data: {chunk}\n\n"
+    
+    return Response(generate(), content_type='text/event-stream')
+```
+
+### Deploy from Template
+
+```bash
+# Create from template
+sunholo init my-api --template agent
+
+# Customize configuration
+cd my-api
+vi config/vac_config.yaml
+
+# Test locally
+sunholo vac chat my-agent --local
+
+# Deploy to production
+sunholo deploy my-agent
+```
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+pytest tests/
+
+# Run specific test file
+pytest tests/test_config.py
+
+# Run with coverage
+pytest --cov=src/sunholo tests/
+
+# Run async tests
+pytest tests/test_async_genai2.py
+```
+
+## 📚 Documentation
+
+- 📖 **Full Documentation**: https://dev.sunholo.com/
+- 🎓 **Tutorials**: https://dev.sunholo.com/docs/howto/
+- 🤖 **VAC Examples**: https://github.com/sunholo-data/vacs-public
+- 🎧 **Audio Overview**: [Listen to the NotebookLM podcast](https://drive.google.com/file/d/1GvwRmiYDjPjN2hXQ8plhnVDByu6TmgCQ/view?usp=drive_link)
+
+## 🤝 Contributing
+
+We welcome contributions! See our [Contributing Guidelines](CONTRIBUTING.md).
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## 📜 License
+
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE.txt) file for details.
+
+```
+Copyright [2024] [Holosun ApS]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+```
+
+## 🙏 Support
+
+- 📧 Email: multivac@sunholo.com
+- 🐛 Issues: [GitHub Issues](https://github.com/sunholo-data/sunholo-py/issues)
+- 💬 Discussions: [GitHub Discussions](https://github.com/sunholo-data/sunholo-py/discussions)
+- 📖 Documentation: https://dev.sunholo.com/

{sunholo-0.140.10.dist-info → sunholo-0.140.12.dist-info}/RECORD

@@ -14,7 +14,7 @@ sunholo/agents/fastapi/base.py,sha256=W-cyF8ZDUH40rc-c-Apw3-_8IIi2e4Y9qRtnoVnsc1
 sunholo/agents/fastapi/qna_routes.py,sha256=lKHkXPmwltu9EH3RMwmD153-J6pE7kWQ4BhBlV3to-s,3864
 sunholo/agents/flask/__init__.py,sha256=dEoByI3gDNUOjpX1uVKP7uPjhfFHJubbiaAv3xLopnk,63
 sunholo/agents/flask/base.py,sha256=vnpxFEOnCmt9humqj-jYPLfJcdwzsop9NorgkJ-tSaU,1756
-sunholo/agents/flask/vac_routes.py,sha256=QfM1nChWLAXhZ4_YYAsiXMss2CeQgxVI0GPD2fNLkmE,34541
+sunholo/agents/flask/vac_routes.py,sha256=TEM0u2vkZC0BSKJABxQVPm4QiUsEFoPOwJZIOxzi1Sk,32621
 sunholo/archive/__init__.py,sha256=qNHWm5rGPVOlxZBZCpA1wTYPbalizRT7f8X4rs2t290,31
 sunholo/archive/archive.py,sha256=PxVfDtO2_2ZEEbnhXSCbXLdeoHoQVImo4y3Jr2XkCFY,1204
 sunholo/auth/__init__.py,sha256=TeP-OY0XGxYV_8AQcVGoh35bvyWhNUcMRfhuD5l44Sk,91
@@ -151,7 +151,7 @@ sunholo/utils/__init__.py,sha256=Hv02T5L2zYWvCso5hzzwm8FQogwBq0OgtUbN_7Quzqc,89
 sunholo/utils/api_key.py,sha256=Ct4bIAQZxzPEw14hP586LpVxBAVi_W9Serpy0BK-7KI,244
 sunholo/utils/big_context.py,sha256=HuP9_r_Nx1jvZHxjMEihgoZAXmnCh80zzsj1fq3mIOg,6021
 sunholo/utils/config.py,sha256=OeYr4UvhRv94e1OVFab4kuQa5TdbbljQjvhnGlkDewM,9160
-sunholo/utils/config_class.py,sha256=uSRiJLj8t5UgWNxaq8W4KPnzxb4SkUJ1avXecDHuP-E,9768
+sunholo/utils/config_class.py,sha256=U0xwyCz68KCJgzyhXd0AmbFnstMBFvZMedb-lLKKa5Q,13363
 sunholo/utils/config_schema.py,sha256=Wv-ncitzljOhgbDaq9qnFqH5LCuxNv59dTGDWgd1qdk,4189
 sunholo/utils/gcp.py,sha256=lus1HH8YhFInw6QRKwfvKZq-Lz-2KQg4ips9v1I_3zE,4783
 sunholo/utils/gcp_project.py,sha256=Fa0IhCX12bZ1ctF_PKN8PNYd7hihEUfb90kilBfUDjg,1411
@@ -168,9 +168,9 @@ sunholo/vertex/init.py,sha256=1OQwcPBKZYBTDPdyU7IM4X4OmiXLdsNV30C-fee2scQ,2875
 sunholo/vertex/memory_tools.py,sha256=tBZxqVZ4InTmdBvLlOYwoSEWu4-kGquc-gxDwZCC4FA,7667
 sunholo/vertex/safety.py,sha256=S9PgQT1O_BQAkcqauWncRJaydiP8Q_Jzmu9gxYfy1VA,2482
 sunholo/vertex/type_dict_to_json.py,sha256=uTzL4o9tJRao4u-gJOFcACgWGkBOtqACmb6ihvCErL8,4694
-sunholo-0.140.10.dist-info/licenses/LICENSE.txt,sha256=SdE3QjnD3GEmqqg9EX3TM9f7WmtOzqS1KJve8rhbYmU,11345
-sunholo-0.140.10.dist-info/METADATA,sha256=EfU0N2go-DI1A6WaL5p_K9TtXwf8PkZCdUWZOoM7j4c,10068
-sunholo-0.140.10.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-sunholo-0.140.10.dist-info/entry_points.txt,sha256=bZuN5AIHingMPt4Ro1b_T-FnQvZ3teBes-3OyO0asl4,49
-sunholo-0.140.10.dist-info/top_level.txt,sha256=wt5tadn5--5JrZsjJz2LceoUvcrIvxjHJe-RxuudxAk,8
-sunholo-0.140.10.dist-info/RECORD,,
+sunholo-0.140.12.dist-info/licenses/LICENSE.txt,sha256=SdE3QjnD3GEmqqg9EX3TM9f7WmtOzqS1KJve8rhbYmU,11345
+sunholo-0.140.12.dist-info/METADATA,sha256=UBt83NkXY5EpTwdtDF5LCOe2IsBXlR1TCVx9EoAuAOA,17116
+sunholo-0.140.12.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+sunholo-0.140.12.dist-info/entry_points.txt,sha256=bZuN5AIHingMPt4Ro1b_T-FnQvZ3teBes-3OyO0asl4,49
+sunholo-0.140.12.dist-info/top_level.txt,sha256=wt5tadn5--5JrZsjJz2LceoUvcrIvxjHJe-RxuudxAk,8
+sunholo-0.140.12.dist-info/RECORD,,

sunholo-0.140.10.dist-info/METADATA

@@ -1,249 +0,0 @@
-Metadata-Version: 2.4
-Name: sunholo
-Version: 0.140.10
-Summary: AI DevOps - a package to help deploy GenAI to the Cloud.
-Author-email: Holosun ApS <multivac@sunholo.com>
-License: Apache License, Version 2.0
-Project-URL: Homepage, https://github.com/sunholo-data/sunholo-py
-Project-URL: Download, https://github.com/sunholo-data/sunholo-py/archive/refs/tags/v0.118.0.tar.gz
-Keywords: llms,devops,google_cloud_platform
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-Requires-Dist: aiohttp
-Requires-Dist: google-auth
-Requires-Dist: ollama>=0.4.7
-Requires-Dist: pillow>=11.0.0
-Requires-Dist: pydantic
-Requires-Dist: requests
-Requires-Dist: ruamel.yaml
-Requires-Dist: tenacity
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Requires-Dist: pytest-cov; extra == "test"
-Provides-Extra: all
-Requires-Dist: aiofiles; extra == "all"
-Requires-Dist: aiohttp; extra == "all"
-Requires-Dist: anthropic[vertex]; extra == "all"
-Requires-Dist: asyncpg; extra == "all"
-Requires-Dist: azure-identity; extra == "all"
-Requires-Dist: azure-storage-blob; extra == "all"
-Requires-Dist: fastapi; extra == "all"
-Requires-Dist: flask; extra == "all"
-Requires-Dist: google-auth; extra == "all"
-Requires-Dist: google-auth-httplib2; extra == "all"
-Requires-Dist: google-auth-oauthlib; extra == "all"
-Requires-Dist: google-cloud-aiplatform>=1.58.0; extra == "all"
-Requires-Dist: google-api-python-client; extra == "all"
-Requires-Dist: google-cloud-alloydb-connector[pg8000]; extra == "all"
-Requires-Dist: google-cloud-bigquery; extra == "all"
-Requires-Dist: google-cloud-build; extra == "all"
-Requires-Dist: google-cloud-service-control; extra == "all"
-Requires-Dist: google-cloud-logging; extra == "all"
-Requires-Dist: google-cloud-storage; extra == "all"
-Requires-Dist: google-cloud-pubsub; extra == "all"
-Requires-Dist: google-cloud-discoveryengine>=0.13.4; extra == "all"
-Requires-Dist: google-cloud-texttospeech; extra == "all"
-Requires-Dist: google-generativeai>=0.7.1; extra == "all"
-Requires-Dist: google-genai>=0.2.2; extra == "all"
-Requires-Dist: gunicorn; extra == "all"
-Requires-Dist: httpcore; extra == "all"
-Requires-Dist: httpx; extra == "all"
-Requires-Dist: jsonschema; extra == "all"
-Requires-Dist: lancedb; extra == "all"
-Requires-Dist: langchain>=0.2.16; extra == "all"
-Requires-Dist: langchain-experimental>=0.0.61; extra == "all"
-Requires-Dist: langchain-community>=0.2.11; extra == "all"
-Requires-Dist: langchain-openai>=0.3.2; extra == "all"
-Requires-Dist: langchain-google-genai>=2.0.9; extra == "all"
-Requires-Dist: langchain_google_alloydb_pg; extra == "all"
-Requires-Dist: langchain-anthropic>=0.1.23; extra == "all"
-Requires-Dist: langchain-google-vertexai; extra == "all"
-Requires-Dist: langchain-unstructured; extra == "all"
-Requires-Dist: langfuse; extra == "all"
-Requires-Dist: mcp; extra == "all"
-Requires-Dist: numpy; extra == "all"
-Requires-Dist: opencv-python; extra == "all"
-Requires-Dist: pg8000; extra == "all"
-Requires-Dist: pgvector; extra == "all"
-Requires-Dist: pillow; extra == "all"
-Requires-Dist: playwright; extra == "all"
-Requires-Dist: psutil; extra == "all"
-Requires-Dist: psycopg2-binary; extra == "all"
-Requires-Dist: pydantic; extra == "all"
-Requires-Dist: pypdf; extra == "all"
-Requires-Dist: python-hcl2; extra == "all"
-Requires-Dist: python-socketio; extra == "all"
-Requires-Dist: pytesseract; extra == "all"
-Requires-Dist: requests; extra == "all"
-Requires-Dist: rich; extra == "all"
-Requires-Dist: sounddevice; extra == "all"
-Requires-Dist: supabase; extra == "all"
-Requires-Dist: tabulate; extra == "all"
-Requires-Dist: tantivy; extra == "all"
-Requires-Dist: tenacity; extra == "all"
-Requires-Dist: tiktoken; extra == "all"
-Requires-Dist: unstructured[all-docs,local-inference]; extra == "all"
-Requires-Dist: xlwings; extra == "all"
-Provides-Extra: langchain
-Requires-Dist: langchain; extra == "langchain"
-Requires-Dist: langchain_experimental; extra == "langchain"
-Requires-Dist: langchain-community; extra == "langchain"
-Requires-Dist: langsmith; extra == "langchain"
-Requires-Dist: langchain-unstructured; extra == "langchain"
-Provides-Extra: azure
-Requires-Dist: azure-identity; extra == "azure"
-Requires-Dist: azure-storage-blob; extra == "azure"
-Provides-Extra: cli
-Requires-Dist: jsonschema>=4.21.1; extra == "cli"
-Requires-Dist: rich; extra == "cli"
-Provides-Extra: database
-Requires-Dist: asyncpg; extra == "database"
-Requires-Dist: supabase; extra == "database"
-Requires-Dist: sqlalchemy; extra == "database"
-Requires-Dist: pg8000; extra == "database"
-Requires-Dist: pgvector; extra == "database"
-Requires-Dist: psycopg2-binary; extra == "database"
-Requires-Dist: lancedb; extra == "database"
-Requires-Dist: tantivy; extra == "database"
-Provides-Extra: pipeline
-Requires-Dist: GitPython; extra == "pipeline"
-Requires-Dist: lark; extra == "pipeline"
-Requires-Dist: langchain>=0.2.16; extra == "pipeline"
-Requires-Dist: langchain-unstructured; extra == "pipeline"
-Requires-Dist: psutil; extra == "pipeline"
-Requires-Dist: pypdf; extra == "pipeline"
-Requires-Dist: pytesseract; extra == "pipeline"
-Requires-Dist: tabulate; extra == "pipeline"
-Requires-Dist: unstructured[all-docs,local-inference]; extra == "pipeline"
-Provides-Extra: gcp
-Requires-Dist: aiofiles; extra == "gcp"
-Requires-Dist: anthropic[vertex]; extra == "gcp"
-Requires-Dist: google-api-python-client; extra == "gcp"
-Requires-Dist: google-auth-httplib2; extra == "gcp"
-Requires-Dist: google-auth-oauthlib; extra == "gcp"
-Requires-Dist: google-cloud-alloydb-connector[pg8000]; extra == "gcp"
-Requires-Dist: google-cloud-aiplatform>=1.58.0; extra == "gcp"
-Requires-Dist: google-cloud-bigquery; extra == "gcp"
-Requires-Dist: google-cloud-build; extra == "gcp"
-Requires-Dist: google-cloud-service-control; extra == "gcp"
-Requires-Dist: google-cloud-storage; extra == "gcp"
-Requires-Dist: google-cloud-logging; extra == "gcp"
-Requires-Dist: google-cloud-pubsub; extra == "gcp"
-Requires-Dist: google-cloud-discoveryengine>=0.13.4; extra == "gcp"
-Requires-Dist: google-cloud-texttospeech; extra == "gcp"
-Requires-Dist: google-genai>=0.2.2; extra == "gcp"
-Requires-Dist: google-generativeai>=0.8.3; extra == "gcp"
-Requires-Dist: langchain; extra == "gcp"
-Requires-Dist: langchain-google-genai>=2.0.0; extra == "gcp"
-Requires-Dist: langchain_google_alloydb_pg>=0.2.2; extra == "gcp"
-Requires-Dist: langchain-google-vertexai; extra == "gcp"
-Requires-Dist: pillow; extra == "gcp"
-Provides-Extra: ollama
-Requires-Dist: pillow; extra == "ollama"
-Requires-Dist: ollama>=0.4.7; extra == "ollama"
-Provides-Extra: openai
-Requires-Dist: langchain-openai>=0.3.2; extra == "openai"
-Requires-Dist: tiktoken; extra == "openai"
-Provides-Extra: anthropic
-Requires-Dist: langchain-anthropic>=0.1.23; extra == "anthropic"
-Requires-Dist: mcp; extra == "anthropic"
-Provides-Extra: tools
-Requires-Dist: openapi-spec-validator; extra == "tools"
-Requires-Dist: playwright; extra == "tools"
-Provides-Extra: http
-Requires-Dist: fastapi; extra == "http"
-Requires-Dist: flask; extra == "http"
-Requires-Dist: gunicorn; extra == "http"
-Requires-Dist: httpcore; extra == "http"
-Requires-Dist: httpx; extra == "http"
-Requires-Dist: langchain; extra == "http"
-Requires-Dist: langfuse; extra == "http"
-Requires-Dist: python-socketio; extra == "http"
-Requires-Dist: requests; extra == "http"
-Requires-Dist: tenacity; extra == "http"
-Provides-Extra: excel
-Requires-Dist: xlwings; extra == "excel"
-Requires-Dist: requests; extra == "excel"
-Requires-Dist: rich; extra == "excel"
-Provides-Extra: iac
-Requires-Dist: python-hcl2; extra == "iac"
-Provides-Extra: tts
-Requires-Dist: google-cloud-texttospeech; extra == "tts"
-Requires-Dist: numpy; extra == "tts"
-Requires-Dist: sounddevice; extra == "tts"
-Provides-Extra: video
-Requires-Dist: opencv-python; extra == "video"
-Dynamic: license-file
-
-[![PyPi Version](https://img.shields.io/pypi/v/sunholo.svg)](https://pypi.python.org/pypi/sunholo/)
-
-## Introduction
-This is the Sunholo Python project, a comprehensive toolkit for working with language models and vector stores on Google Cloud Platform. It provides a wide range of functionalities and utilities to facilitate the development and deployment of language model applications.
-
-Please refer to the website for full documentation at https://dev.sunholo.com/
-
-## Listen to the audio file:
-
-A [NotebookLM](https://notebooklm.google/) generated podcast of the codebase that may help give you an overview of what the library is capable of:
-
-[Listen to the audio file from Google Drive](https://drive.google.com/file/d/1GvwRmiYDjPjN2hXQ8plhnVDByu6TmgCQ/view?usp=drive_link) or on the website at https://dev.sunholo.com/docs/ 
-
-> "Ever wish you could build your own AI?..."
-
-## Tests via pytest
-
-If loading from GitHub, run tests:
-
-```bash
-pip install pytest
-pip install . --use-feature=in-tree-build
-pytest tests
-```
-
-## Local dev
-
-```sh
-uv tool install --from "sunholo[cli]" sunholo --with ".[all]"
-```
-
-## Demos
-
-Using https://github.com/charmbracelet/vhs
-
-```sh
-vhs record > cassette.tape
-```
-
-Then make gif:
-
-```sh
-vhs docs/tapes/config-list.tape
-```
-
-
-
-```
-   Copyright [2024] [Holosun ApS]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
-```
-