SimplerLLM 0.3.5__tar.gz → 0.3.7__tar.gz

simplerllm-0.3.7/MANIFEST.in

@@ -0,0 +1,3 @@
+include requirements.txt
+include README.md
+include LICENSE

{simplerllm-0.3.5 → simplerllm-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SimplerLLM
-Version: 0.3.5
+Version: 0.3.7
 Summary: An easy-to-use Library for interacting with language models.
 Home-page: https://github.com/hassancs91/SimplerLLM
 Author: Hasan Aboul Hasan
@@ -18,6 +18,8 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
@@ -43,7 +45,6 @@ Requires-Dist: colorama>=0.4
 Requires-Dist: scipy>=1.15
 Requires-Dist: tiktoken>=0.9
 Requires-Dist: qdrant-client==1.14.3
-Requires-Dist: voyageai==0.3.3
 Requires-Dist: pydub>=0.25.1
 Requires-Dist: elevenlabs>=2.22.0
 Requires-Dist: moviepy>=1.0.3
@@ -52,6 +53,8 @@ Provides-Extra: transformers
 Requires-Dist: transformers>=4.36.0; extra == "transformers"
 Requires-Dist: torch>=2.0.0; extra == "transformers"
 Requires-Dist: accelerate>=0.25.0; extra == "transformers"
+Provides-Extra: voyage
+Requires-Dist: voyageai>=0.3.3; extra == "voyage"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -97,9 +100,9 @@ pip install pygame>=2.5.0
 ## Key Features
 
 ### 🔗 Unified LLM Interface
-- **8 LLM Providers**: OpenAI, Anthropic, Google Gemini, Cohere, OpenRouter, DeepSeek, and Ollama
+- **9+ LLM Providers**: OpenAI, Anthropic, Google Gemini, Cohere, OpenRouter, CometAPI, DeepSeek, and Ollama
 - **Consistent API**: Same interface across all providers
-- **100+ Models**: Access to diverse models through OpenRouter integration
+- **500+ Models**: Access to diverse models through OpenRouter and CometAPI integrations
 - **Async Support**: Full asynchronous capabilities
 
 ### 🛡️ Reliability & Failover
@@ -113,7 +116,7 @@ pip install pygame>=2.5.0
 - **Retry Logic**: Automatic retry on validation failures
 
 ### 🔍 Vector Operations
-- **Multiple Providers**: OpenAI, Voyage AI, and Cohere embeddings
+- **Multiple Providers**: OpenAI, Voyage AI, Cohere, OpenRouter, and CometAPI embeddings
 - **Local & Cloud Storage**: Local vector database and Qdrant integration
 - **Semantic Search**: Advanced similarity search capabilities
 
@@ -163,6 +166,9 @@ cohere_llm = LLM.create(provider=LLMProvider.COHERE, model_name="command-r-plus"
 # OpenRouter (Access to 100+ models)
 openrouter_llm = LLM.create(provider=LLMProvider.OPENROUTER, model_name="openai/gpt-4o")
 
+# CometAPI (Access to 500+ models with native model names)
+cometapi_llm = LLM.create(provider=LLMProvider.COMETAPI, model_name="claude-sonnet-4-6")
+
 # DeepSeek
 deepseek_llm = LLM.create(provider=LLMProvider.DEEPSEEK, model_name="deepseek-chat")
 
@@ -262,6 +268,18 @@ cohere_embeddings = EmbeddingsLLM.create(
     model_name="embed-english-v3.0"
 )
 
+# OpenRouter Embeddings (any model via one API key)
+openrouter_embeddings = EmbeddingsLLM.create(
+    provider=EmbeddingsProvider.OPENROUTER,
+    model_name="openai/text-embedding-3-small"
+)
+
+# CometAPI Embeddings (one key, native model names)
+cometapi_embeddings = EmbeddingsLLM.create(
+    provider=EmbeddingsProvider.COMETAPI,
+    model_name="text-embedding-3-small"
+)
+
 # Generate embeddings
 text = "SimplerLLM makes AI development easier"
 embeddings = openai_embeddings.generate_embeddings(text)
@@ -490,6 +508,7 @@ COHERE_API_KEY=your_cohere_api_key
 OPENROUTER_API_KEY=your_openrouter_api_key
 OPENROUTER_SITE_URL=your_site_url  # Optional
 OPENROUTER_SITE_NAME=your_site_name  # Optional
+COMETAPI_API_KEY=your_cometapi_api_key  # COMETAPI_KEY also works
 
 # Embeddings
 VOYAGE_API_KEY=your_voyage_api_key

{simplerllm-0.3.5 → simplerllm-0.3.7}/README.md

@@ -29,9 +29,9 @@ pip install pygame>=2.5.0
 ## Key Features
 
 ### 🔗 Unified LLM Interface
-- **8 LLM Providers**: OpenAI, Anthropic, Google Gemini, Cohere, OpenRouter, DeepSeek, and Ollama
+- **9+ LLM Providers**: OpenAI, Anthropic, Google Gemini, Cohere, OpenRouter, CometAPI, DeepSeek, and Ollama
 - **Consistent API**: Same interface across all providers
-- **100+ Models**: Access to diverse models through OpenRouter integration
+- **500+ Models**: Access to diverse models through OpenRouter and CometAPI integrations
 - **Async Support**: Full asynchronous capabilities
 
 ### 🛡️ Reliability & Failover
@@ -45,7 +45,7 @@ pip install pygame>=2.5.0
 - **Retry Logic**: Automatic retry on validation failures
 
 ### 🔍 Vector Operations
-- **Multiple Providers**: OpenAI, Voyage AI, and Cohere embeddings
+- **Multiple Providers**: OpenAI, Voyage AI, Cohere, OpenRouter, and CometAPI embeddings
 - **Local & Cloud Storage**: Local vector database and Qdrant integration
 - **Semantic Search**: Advanced similarity search capabilities
 
@@ -95,6 +95,9 @@ cohere_llm = LLM.create(provider=LLMProvider.COHERE, model_name="command-r-plus"
 # OpenRouter (Access to 100+ models)
 openrouter_llm = LLM.create(provider=LLMProvider.OPENROUTER, model_name="openai/gpt-4o")
 
+# CometAPI (Access to 500+ models with native model names)
+cometapi_llm = LLM.create(provider=LLMProvider.COMETAPI, model_name="claude-sonnet-4-6")
+
 # DeepSeek
 deepseek_llm = LLM.create(provider=LLMProvider.DEEPSEEK, model_name="deepseek-chat")
 
@@ -194,6 +197,18 @@ cohere_embeddings = EmbeddingsLLM.create(
     model_name="embed-english-v3.0"
 )
 
+# OpenRouter Embeddings (any model via one API key)
+openrouter_embeddings = EmbeddingsLLM.create(
+    provider=EmbeddingsProvider.OPENROUTER,
+    model_name="openai/text-embedding-3-small"
+)
+
+# CometAPI Embeddings (one key, native model names)
+cometapi_embeddings = EmbeddingsLLM.create(
+    provider=EmbeddingsProvider.COMETAPI,
+    model_name="text-embedding-3-small"
+)
+
 # Generate embeddings
 text = "SimplerLLM makes AI development easier"
 embeddings = openai_embeddings.generate_embeddings(text)
@@ -422,6 +437,7 @@ COHERE_API_KEY=your_cohere_api_key
 OPENROUTER_API_KEY=your_openrouter_api_key
 OPENROUTER_SITE_URL=your_site_url  # Optional
 OPENROUTER_SITE_NAME=your_site_name  # Optional
+COMETAPI_API_KEY=your_cometapi_api_key  # COMETAPI_KEY also works
 
 # Embeddings
 VOYAGE_API_KEY=your_voyage_api_key

{simplerllm-0.3.5 → simplerllm-0.3.7}/SimplerLLM/language/__init__.py

@@ -17,6 +17,8 @@ from .embeddings import (
     OpenAIEmbeddings,
     VoyageEmbeddings,
     CohereEmbeddings,
+    OpenRouterEmbeddings,
+    CometAPIEmbeddings,
 )
 from .llm_addons import (
     create_optimized_prompt,
@@ -63,6 +65,8 @@ __all__ = [
     'OpenAIEmbeddings',
     'VoyageEmbeddings',
     'CohereEmbeddings',
+    'OpenRouterEmbeddings',
+    'CometAPIEmbeddings',
     # LLM Addons
     'create_optimized_prompt',
     'generate_pydantic_json_model',

{simplerllm-0.3.5 → simplerllm-0.3.7}/SimplerLLM/language/embeddings/__init__.py

@@ -2,8 +2,9 @@
 Embeddings Module - Unified Interface for Text Embeddings.
 
 This module provides a factory-based interface for generating text embeddings
-using multiple providers (OpenAI, Voyage AI, Cohere). It supports both
-synchronous and asynchronous operations with provider-specific optimizations.
+using multiple providers (OpenAI, Voyage AI, Cohere, OpenRouter). It supports
+both synchronous and asynchronous operations with provider-specific
+optimizations.
 
 Supported Providers:
     OpenAI:
@@ -22,10 +23,16 @@ Supported Providers:
         - embed-multilingual-v3.0: 100+ languages (1024 dimensions)
         - embed-v4.0: Latest model with configurable dimensions
 
+    OpenRouter (unified gateway, models use 'provider/model' format):
+        - openai/text-embedding-3-small (default): 1536 dimensions
+        - openai/text-embedding-3-large: 3072 dimensions
+        - qwen/qwen3-embedding-8b: Open-weights multilingual embeddings
+
 Environment Variables:
     OPENAI_API_KEY: Required for OpenAI embeddings
     VOYAGE_API_KEY: Required for Voyage AI embeddings
     COHERE_API_KEY: Required for Cohere embeddings
+    OPENROUTER_API_KEY: Required for OpenRouter embeddings
 
 Quick Start:
     >>> from SimplerLLM.language import EmbeddingsLLM, EmbeddingsProvider
@@ -80,6 +87,8 @@ from .providers import (
     OpenAIEmbeddings,
     VoyageEmbeddings,
     CohereEmbeddings,
+    OpenRouterEmbeddings,
+    CometAPIEmbeddings,
 )
 
 __all__ = [
@@ -91,4 +100,6 @@ __all__ = [
     "OpenAIEmbeddings",
     "VoyageEmbeddings",
     "CohereEmbeddings",
+    "OpenRouterEmbeddings",
+    "CometAPIEmbeddings",
 ]

{simplerllm-0.3.5 → simplerllm-0.3.7}/SimplerLLM/language/embeddings/base.py

@@ -13,6 +13,8 @@ from .providers import (
     OpenAIEmbeddings,
     VoyageEmbeddings,
     CohereEmbeddings,
+    OpenRouterEmbeddings,
+    CometAPIEmbeddings,
 )
 
 
@@ -21,6 +23,8 @@ DEFAULT_MODELS = {
     EmbeddingsProvider.OPENAI: "text-embedding-3-small",
     EmbeddingsProvider.VOYAGE: "voyage-3",
     EmbeddingsProvider.COHERE: "embed-english-v3.0",
+    EmbeddingsProvider.OPENROUTER: "openai/text-embedding-3-small",
+    EmbeddingsProvider.COMETAPI: "text-embedding-3-small",
 }
 
 
@@ -36,6 +40,8 @@ class EmbeddingsLLM:
         - OPENAI: OpenAI's text-embedding models
         - VOYAGE: Voyage AI embeddings with retrieval optimization
         - COHERE: Cohere embeddings with multilingual support
+        - OPENROUTER: Any embedding model via the OpenRouter gateway
+        - COMETAPI: Embedding models via the CometAPI aggregator
 
     Example:
         >>> from SimplerLLM.language.embeddings import EmbeddingsLLM, EmbeddingsProvider
@@ -60,6 +66,8 @@ class EmbeddingsLLM:
         - OpenAIEmbeddings: OpenAI-specific implementation
         - VoyageEmbeddings: Voyage AI-specific implementation
         - CohereEmbeddings: Cohere-specific implementation
+        - OpenRouterEmbeddings: OpenRouter gateway implementation
+        - CometAPIEmbeddings: CometAPI aggregator implementation
     """
 
     def __init__(
@@ -104,18 +112,23 @@ class EmbeddingsLLM:
                 - EmbeddingsProvider.OPENAI: OpenAI embeddings
                 - EmbeddingsProvider.VOYAGE: Voyage AI embeddings
                 - EmbeddingsProvider.COHERE: Cohere embeddings
+                - EmbeddingsProvider.OPENROUTER: OpenRouter gateway embeddings
+                - EmbeddingsProvider.COMETAPI: CometAPI aggregator embeddings
             model_name: Model identifier. If not provided, uses provider default:
                 - OPENAI: "text-embedding-3-small"
                 - VOYAGE: "voyage-3"
                 - COHERE: "embed-english-v3.0"
+                - OPENROUTER: "openai/text-embedding-3-small"
+                - COMETAPI: "text-embedding-3-small"
             api_key: API key for authentication. Falls back to environment
-                variables (OPENAI_API_KEY, VOYAGE_API_KEY, COHERE_API_KEY).
+                variables (OPENAI_API_KEY, VOYAGE_API_KEY, COHERE_API_KEY,
+                OPENROUTER_API_KEY, COMETAPI_API_KEY/COMETAPI_KEY).
             user_id: Optional user identifier for tracking/billing.
 
         Returns:
             Provider-specific embeddings instance (OpenAIEmbeddings,
-            VoyageEmbeddings, or CohereEmbeddings), or None if provider
-            is not specified.
+            VoyageEmbeddings, CohereEmbeddings, OpenRouterEmbeddings,
+            or CometAPIEmbeddings), or None if provider is not specified.
 
         Raises:
             ValueError: If provider is not a valid EmbeddingsProvider enum.
@@ -138,6 +151,18 @@ class EmbeddingsLLM:
             ...     model_name="embed-multilingual-v3.0",
             ...     api_key="your-api-key"
             ... )
+            >>>
+            >>> # Any model through OpenRouter
+            >>> embeddings = EmbeddingsLLM.create(
+            ...     provider=EmbeddingsProvider.OPENROUTER,
+            ...     model_name="openai/text-embedding-3-large"
+            ... )
+            >>>
+            >>> # Through CometAPI
+            >>> embeddings = EmbeddingsLLM.create(
+            ...     provider=EmbeddingsProvider.COMETAPI,
+            ...     model_name="text-embedding-3-small"
+            ... )
         """
         if provider is None:
             return None
@@ -145,7 +170,9 @@ class EmbeddingsLLM:
         if not isinstance(provider, EmbeddingsProvider):
             raise ValueError(
                 f"provider must be an EmbeddingsProvider enum, got {type(provider).__name__}. "
-                f"Use EmbeddingsProvider.OPENAI, EmbeddingsProvider.VOYAGE, or EmbeddingsProvider.COHERE"
+                f"Use EmbeddingsProvider.OPENAI, EmbeddingsProvider.VOYAGE, "
+                f"EmbeddingsProvider.COHERE, EmbeddingsProvider.OPENROUTER, "
+                f"or EmbeddingsProvider.COMETAPI"
             )
 
         # Use default model if not specified
@@ -157,6 +184,10 @@ class EmbeddingsLLM:
             return VoyageEmbeddings(provider, model_name, api_key, user_id)
         elif provider == EmbeddingsProvider.COHERE:
             return CohereEmbeddings(provider, model_name, api_key, user_id)
+        elif provider == EmbeddingsProvider.OPENROUTER:
+            return OpenRouterEmbeddings(provider, model_name, api_key, user_id)
+        elif provider == EmbeddingsProvider.COMETAPI:
+            return CometAPIEmbeddings(provider, model_name, api_key, user_id)
         else:
             return None
 

{simplerllm-0.3.5 → simplerllm-0.3.7}/SimplerLLM/language/embeddings/models.py

@@ -28,6 +28,15 @@ class EmbeddingsProvider(Enum):
             Models: embed-english-v3.0, embed-multilingual-v3.0
             Features: input_type for search optimization, truncation control
 
+        OPENROUTER: OpenRouter unified gateway. Access embedding models
+            from multiple providers through a single API.
+            Models use 'provider/model' format:
+            openai/text-embedding-3-small, qwen/qwen3-embedding-8b
+
+        COMETAPI: CometAPI all-in-one aggregator. Access OpenAI embedding
+            models (and more) through a single CometAPI key, using native
+            model names: text-embedding-3-small, text-embedding-3-large
+
     Example:
         >>> from SimplerLLM.language.embeddings import EmbeddingsProvider
         >>> provider = EmbeddingsProvider.OPENAI
@@ -37,3 +46,5 @@ class EmbeddingsProvider(Enum):
     OPENAI = 1
     VOYAGE = 2
     COHERE = 3
+    OPENROUTER = 4
+    COMETAPI = 5

{simplerllm-0.3.5 → simplerllm-0.3.7}/SimplerLLM/language/embeddings/providers.py

@@ -5,6 +5,8 @@ This module contains the concrete implementations for each embedding provider:
 - OpenAIEmbeddings: OpenAI's text-embedding models
 - VoyageEmbeddings: Voyage AI embeddings with retrieval optimization
 - CohereEmbeddings: Cohere embeddings with multilingual support
+- OpenRouterEmbeddings: Any embedding model via the OpenRouter gateway
+- CometAPIEmbeddings: Embedding models via the CometAPI aggregator
 """
 
 import os
@@ -13,6 +15,8 @@ from typing import List, Optional, Union, Any
 import SimplerLLM.language.llm_providers.openai_llm as openai_llm
 import SimplerLLM.language.llm_providers.voyage_llm as voyage_llm
 import SimplerLLM.language.llm_providers.cohere_llm as cohere_llm
+import SimplerLLM.language.llm_providers.openrouter_llm as openrouter_llm
+import SimplerLLM.language.llm_providers.cometapi_llm as cometapi_llm
 from SimplerLLM.language.llm_providers.llm_response_models import LLMEmbeddingsResponse
 
 from .models import EmbeddingsProvider
@@ -184,6 +188,260 @@ class OpenAIEmbeddings(BaseEmbeddings):
         )
 
 
+class OpenRouterEmbeddings(BaseEmbeddings):
+    """
+    OpenRouter embeddings implementation.
+
+    Generates text embeddings through OpenRouter's unified gateway, giving
+    access to embedding models from multiple providers with a single API key.
+    Model names use the 'provider/model' format.
+
+    Attributes:
+        provider: Always EmbeddingsProvider.OPENROUTER
+        model_name: OpenRouter model identifier in 'provider/model' format
+            (default: "openai/text-embedding-3-small")
+        api_key: OpenRouter API key (falls back to OPENROUTER_API_KEY env var)
+
+    Example:
+        >>> embeddings = OpenRouterEmbeddings(
+        ...     provider=EmbeddingsProvider.OPENROUTER,
+        ...     model_name="openai/text-embedding-3-small"
+        ... )
+        >>> vector = embeddings.generate_embeddings("Hello world")
+        >>> print(len(vector))  # 1536
+    """
+
+    def __init__(
+        self,
+        provider: EmbeddingsProvider,
+        model_name: str,
+        api_key: Optional[str] = None,
+        user_id: Optional[str] = None,
+    ):
+        super().__init__(provider, model_name, api_key, user_id)
+        self.api_key = api_key or os.getenv("OPENROUTER_API_KEY", "")
+
+    def generate_embeddings(
+        self,
+        user_input: Union[str, List[str]],
+        model_name: Optional[str] = None,
+        full_response: bool = False,
+    ) -> Union[List[float], List[List[float]], LLMEmbeddingsResponse]:
+        """
+        Generate embeddings using any model through OpenRouter.
+
+        Args:
+            user_input: Text or list of texts to embed. Single strings return
+                a single embedding vector. Lists return a list of vectors.
+            model_name: Model name override in 'provider/model' format
+                (e.g., 'openai/text-embedding-3-large'). If not provided,
+                uses the instance's model_name.
+            full_response: If True, returns LLMEmbeddingsResponse with metadata.
+                If False, returns just the embedding vector(s).
+
+        Returns:
+            If full_response=False:
+                - Single input: List[float] - embedding vector
+                - List input: List[List[float]] - list of embedding vectors
+            If full_response=True:
+                LLMEmbeddingsResponse with generated_embedding, model,
+                process_time, and llm_provider_response.
+
+        Raises:
+            ValueError: If user_input is empty or None.
+            Exception: On API errors after retry attempts exhausted.
+
+        Example:
+            >>> embeddings = OpenRouterEmbeddings(
+            ...     provider=EmbeddingsProvider.OPENROUTER,
+            ...     model_name="openai/text-embedding-3-small"
+            ... )
+            >>> # Single text
+            >>> vector = embeddings.generate_embeddings("Hello world")
+            >>> print(f"Dimensions: {len(vector)}")  # 1536
+            >>>
+            >>> # Different model through the same gateway
+            >>> vector = embeddings.generate_embeddings(
+            ...     "Hello world",
+            ...     model_name="qwen/qwen3-embedding-8b"
+            ... )
+        """
+        model_name = model_name if model_name is not None else self.model_name
+
+        return openrouter_llm.generate_embeddings(
+            user_input=user_input,
+            model_name=model_name,
+            full_response=full_response,
+            api_key=self.api_key
+        )
+
+    async def generate_embeddings_async(
+        self,
+        user_input: Union[str, List[str]],
+        model_name: Optional[str] = None,
+        full_response: bool = False,
+    ) -> Union[List[float], List[List[float]], LLMEmbeddingsResponse]:
+        """
+        Asynchronously generate embeddings through OpenRouter.
+
+        This is the async version of generate_embeddings(). See
+        generate_embeddings() for full parameter documentation.
+
+        Args:
+            user_input: Text or list of texts to embed.
+            model_name: Model name override in 'provider/model' format.
+            full_response: If True, returns LLMEmbeddingsResponse.
+
+        Returns:
+            Embedding vector(s) or LLMEmbeddingsResponse.
+
+        Example:
+            >>> import asyncio
+            >>> embeddings = OpenRouterEmbeddings(
+            ...     provider=EmbeddingsProvider.OPENROUTER,
+            ...     model_name="openai/text-embedding-3-small"
+            ... )
+            >>> vector = asyncio.run(
+            ...     embeddings.generate_embeddings_async("Hello world")
+            ... )
+        """
+        model_name = model_name if model_name is not None else self.model_name
+
+        return await openrouter_llm.generate_embeddings_async(
+            user_input=user_input,
+            model_name=model_name,
+            full_response=full_response,
+            api_key=self.api_key
+        )
+
+
+class CometAPIEmbeddings(BaseEmbeddings):
+    """
+    CometAPI embeddings implementation.
+
+    Generates text embeddings through CometAPI's all-in-one aggregator,
+    giving access to OpenAI embedding models (and more) with a single
+    CometAPI key. Model names use their native format without a prefix.
+
+    Attributes:
+        provider: Always EmbeddingsProvider.COMETAPI
+        model_name: Native model identifier
+            (default: "text-embedding-3-small")
+        api_key: CometAPI key (falls back to COMETAPI_API_KEY then
+            COMETAPI_KEY env vars)
+
+    Example:
+        >>> embeddings = CometAPIEmbeddings(
+        ...     provider=EmbeddingsProvider.COMETAPI,
+        ...     model_name="text-embedding-3-small"
+        ... )
+        >>> vector = embeddings.generate_embeddings("Hello world")
+        >>> print(len(vector))  # 1536
+    """
+
+    def __init__(
+        self,
+        provider: EmbeddingsProvider,
+        model_name: str,
+        api_key: Optional[str] = None,
+        user_id: Optional[str] = None,
+    ):
+        super().__init__(provider, model_name, api_key, user_id)
+        self.api_key = api_key or os.getenv("COMETAPI_API_KEY") or os.getenv("COMETAPI_KEY", "")
+
+    def generate_embeddings(
+        self,
+        user_input: Union[str, List[str]],
+        model_name: Optional[str] = None,
+        full_response: bool = False,
+    ) -> Union[List[float], List[List[float]], LLMEmbeddingsResponse]:
+        """
+        Generate embeddings using an embedding model through CometAPI.
+
+        Args:
+            user_input: Text or list of texts to embed. Single strings return
+                a single embedding vector. Lists return a list of vectors.
+            model_name: Model name override (e.g., 'text-embedding-3-large').
+                If not provided, uses the instance's model_name.
+            full_response: If True, returns LLMEmbeddingsResponse with metadata.
+                If False, returns just the embedding vector(s).
+
+        Returns:
+            If full_response=False:
+                - Single input: List[float] - embedding vector
+                - List input: List[List[float]] - list of embedding vectors
+            If full_response=True:
+                LLMEmbeddingsResponse with generated_embedding, model,
+                process_time, and llm_provider_response.
+
+        Raises:
+            ValueError: If user_input is empty or None.
+            Exception: On API errors after retry attempts exhausted.
+
+        Example:
+            >>> embeddings = CometAPIEmbeddings(
+            ...     provider=EmbeddingsProvider.COMETAPI,
+            ...     model_name="text-embedding-3-small"
+            ... )
+            >>> # Single text
+            >>> vector = embeddings.generate_embeddings("Hello world")
+            >>> print(f"Dimensions: {len(vector)}")  # 1536
+            >>>
+            >>> # Larger model through the same key
+            >>> vector = embeddings.generate_embeddings(
+            ...     "Hello world",
+            ...     model_name="text-embedding-3-large"
+            ... )
+        """
+        model_name = model_name if model_name is not None else self.model_name
+
+        return cometapi_llm.generate_embeddings(
+            user_input=user_input,
+            model_name=model_name,
+            full_response=full_response,
+            api_key=self.api_key
+        )
+
+    async def generate_embeddings_async(
+        self,
+        user_input: Union[str, List[str]],
+        model_name: Optional[str] = None,
+        full_response: bool = False,
+    ) -> Union[List[float], List[List[float]], LLMEmbeddingsResponse]:
+        """
+        Asynchronously generate embeddings through CometAPI.
+
+        This is the async version of generate_embeddings(). See
+        generate_embeddings() for full parameter documentation.
+
+        Args:
+            user_input: Text or list of texts to embed.
+            model_name: Model name override.
+            full_response: If True, returns LLMEmbeddingsResponse.
+
+        Returns:
+            Embedding vector(s) or LLMEmbeddingsResponse.
+
+        Example:
+            >>> import asyncio
+            >>> embeddings = CometAPIEmbeddings(
+            ...     provider=EmbeddingsProvider.COMETAPI,
+            ...     model_name="text-embedding-3-small"
+            ... )
+            >>> vector = asyncio.run(
+            ...     embeddings.generate_embeddings_async("Hello world")
+            ... )
+        """
+        model_name = model_name if model_name is not None else self.model_name
+
+        return await cometapi_llm.generate_embeddings_async(
+            user_input=user_input,
+            model_name=model_name,
+            full_response=full_response,
+            api_key=self.api_key
+        )
+
+
 class VoyageEmbeddings(BaseEmbeddings):
     """
     Voyage AI embeddings implementation.

{simplerllm-0.3.5 → simplerllm-0.3.7}/SimplerLLM/language/llm/base.py

@@ -25,6 +25,7 @@ class LLMProvider(Enum):
     PERPLEXITY = 9
     MOONSHOT = 10
     HUGGING_FACE_LOCAL = 11
+    COMETAPI = 12
 
 class LLM:
     def __init__(
@@ -89,6 +90,9 @@ class LLM:
         if provider == LLMProvider.HUGGING_FACE_LOCAL:
             from .wrappers.hf_local_wrapper import HuggingFaceLocalLLM
             return HuggingFaceLocalLLM(provider, model_name, temperature, top_p, verbose=verbose)
+        if provider == LLMProvider.COMETAPI:
+            from .wrappers.cometapi_wrapper import CometAPILLM
+            return CometAPILLM(provider, model_name, temperature, top_p, api_key, verbose=verbose)
         else:
             return None
 

{simplerllm-0.3.5 → simplerllm-0.3.7}/SimplerLLM/language/llm/reliable.py

@@ -26,6 +26,9 @@ PROVIDER_CAPABILITIES: Dict[LLMProvider, Set[str]] = {
     LLMProvider.OLLAMA: {"images"},
     LLMProvider.COHERE: set(),
     LLMProvider.HUGGING_FACE_LOCAL: set(),
+    LLMProvider.COMETAPI: {
+        "reasoning_effort", "timeout", "images", "detail"
+    },
 }
 
 # Universal parameters supported by all providers