Claude 24f816b6a3
Consolidate 22 sibling repos into layered organism structure
Place useful parts of the surrounding repos into sica-fondt by layer, per the
body model (Ada = membrane; brain/endocrine/capabilities/knowledge non-Ada):

- brain/        LLM reasoning + providers (dapr, hermes, MoMoA)
- capabilities/ REPRAG sidecars: hermes tools/skills, dapr tools, parallel
                dispatch, A51 channels, and the OSINT cluster
- knowledge/    LORAG corpus: 754 cyber-skills, agency personas, secure-coding,
                MITRE ATT&CK data
- reference/    defensive threat-reference (C3, shhbruh doc) + AdaYaml parser

License handling: AGPL sources (worldosint, advanced_evolution, mercury,
Reticulum) and GPL DeTTECT are SPEC-only clean-room/port descriptions — no
copyleft code copied. MIT/Apache/data parts copied as working trees.

Safety: shhbruh escape/persistence material and C3 covert-C2 kept as reference
only, not wired into the running organism. See CONSOLIDATION.md.

https://claude.ai/code/session_01UehUqEXXJJCsHoA4voCU5c
2026-06-10 06:53:01 +00:00

109 lines
3.7 KiB
Python

#
# Copyright 2026 The Dapr Authors
# 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.
#
from dapr_agents.types.llm import NVIDIAClientConfig
from dapr_agents.llm.base import LLMClientBase
from typing import Any, Optional
from pydantic import Field
from openai import OpenAI
import os
import logging
logger = logging.getLogger(__name__)
class NVIDIAClientBase(LLMClientBase):
"""
Base class for managing NVIDIA LLM clients.
Handles client initialization, configuration, and shared logic specific to NVIDIA's API.
"""
api_key: Optional[str] = Field(
default=None,
description="API key for authenticating with the NVIDIA LLM API. If not provided, it will be sourced from the 'NVIDIA_API_KEY' environment variable.",
)
base_url: Optional[str] = Field(
default="https://integrate.api.nvidia.com/v1",
description="Base URL for the NVIDIA LLM API endpoints.",
)
def model_post_init(self, __context: Any) -> None:
"""
Initializes private attributes and performs any post-validation setup.
This includes setting up provider-specific attributes such as configuration and client instances.
Args:
__context (Any): Additional context for post-initialization (not used here).
"""
self._provider = "nvidia"
# Use environment variable if `api_key` is not explicitly provided
if self.api_key is None:
self.api_key = os.environ.get("NVIDIA_API_KEY")
if self.api_key is None:
raise ValueError(
"API key is required. Set it explicitly or in the 'NVIDIA_API_KEY' environment variable."
)
# Set up the private config and client attributes
self._config: NVIDIAClientConfig = self.get_config()
self._client: OpenAI = self.get_client()
return super().model_post_init(__context)
def get_config(self) -> NVIDIAClientConfig:
"""
Returns the configuration object for the NVIDIA LLM API client.
This configuration includes the API key and base URL, ensuring the client can communicate with the API.
Returns:
NVIDIAClientConfig: Configuration object containing API credentials and endpoint details.
"""
return NVIDIAClientConfig(api_key=self.api_key, base_url=self.base_url)
def get_client(self) -> OpenAI:
"""
Initializes and returns the NVIDIA LLM API client.
This method sets up the client using the provided configuration.
Returns:
OpenAI: The initialized NVIDIA API client instance.
"""
config = self.config
logger.info("Initializing NVIDIA API client...")
return OpenAI(api_key=config.api_key, base_url=config.base_url)
@property
def config(self) -> NVIDIAClientConfig:
"""
Provides access to the NVIDIA API client configuration.
Returns:
NVIDIAClientConfig: Configuration object for the NVIDIA API client.
"""
return self._config
@property
def client(self) -> OpenAI:
"""
Provides access to the NVIDIA API client instance.
Returns:
OpenAI: The NVIDIA API client instance.
"""
return self._client