socratic-nexus 0.3.1__tar.gz

socratic_nexus-0.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Socrates Nexus Contributors
+
+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.

socratic_nexus-0.3.1/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: socratic-nexus
+Version: 0.3.1
+Summary: Universal LLM client for production - works with Claude, GPT-4, Gemini, Llama, and any LLM. Built-in integrations with Openclaw and LangChain.
+Author: Socrates Nexus Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/Nireus79/socrates-nexus
+Project-URL: Documentation, https://github.com/Nireus79/socrates-nexus/tree/main/docs
+Project-URL: Repository, https://github.com/Nireus79/socrates-nexus
+Project-URL: Source Code, https://github.com/Nireus79/socrates-nexus
+Project-URL: Bug Tracker, https://github.com/Nireus79/socrates-nexus/issues
+Project-URL: Changelog, https://github.com/Nireus79/socrates-nexus/releases
+Keywords: llm,ai,claude,gpt-4,gemini,ollama,llama,production,multi-llm,universal-client,retry,streaming,async,token-tracking
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40.0; extra == "anthropic"
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: google
+Requires-Dist: google-generativeai>=0.1.0rc1; extra == "google"
+Provides-Extra: ollama
+Requires-Dist: ollama>=0.0.8; extra == "ollama"
+Provides-Extra: huggingface
+Requires-Dist: huggingface-hub>=0.17.0; extra == "huggingface"
+Provides-Extra: openclaw
+Provides-Extra: langchain
+Requires-Dist: langchain>=0.1.0; extra == "langchain"
+Provides-Extra: all
+Requires-Dist: anthropic>=0.40.0; extra == "all"
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: ollama>=0.0.8; extra == "all"
+Requires-Dist: huggingface-hub>=0.17.0; extra == "all"
+Provides-Extra: integrations
+Requires-Dist: langchain>=0.1.0; extra == "integrations"
+Provides-Extra: full
+Requires-Dist: anthropic>=0.40.0; extra == "full"
+Requires-Dist: openai>=1.0.0; extra == "full"
+Requires-Dist: google-generativeai>=0.3.0; extra == "full"
+Requires-Dist: ollama>=0.0.8; extra == "full"
+Requires-Dist: huggingface-hub>=0.17.0; extra == "full"
+Requires-Dist: langchain>=0.1.0; extra == "full"
+Provides-Extra: async
+Requires-Dist: asyncio>=3.4.3; extra == "async"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Dynamic: license-file
+
+# Socratic Nexus (socrates-nexus)
+
+Universal LLM abstraction layer providing unified access to multiple AI providers
+
+## Overview
+
+socrates-nexus is a specialized component of the Socratic ecosystem that provides comprehensive functionality for universal llm abstraction layer providing unified access to multiple ai providers. It offers a production-ready, well-tested solution for integrating into larger Socratic systems.
+
+## Key Features
+
+- Multi-provider support
+- Unified client interface
+- Async/sync API support
+- Model standardization
+
+## Installation
+
+### Prerequisites
+- Python 3.8+
+- pip or poetry package manager
+
+### Via pip
+
+```bash
+pip install socrates-nexus
+```
+
+### Via poetry
+
+```bash
+poetry add socrates-nexus
+```
+
+### From source
+
+```bash
+git clone https://github.com/socratic-ai/socrates-nexus.git
+cd socrates-nexus
+pip install -e .
+```
+
+## Quick Start
+
+### Basic Usage
+
+```python
+from socrates_nexus import Client
+
+# Initialize the component
+client = Client()
+
+# Perform basic operation
+result = client.process()
+print(result)
+```
+
+### Configuration
+
+```python
+from socrates_nexus import Client
+
+# Configure with custom settings
+client = Client(
+    api_key="your-api-key",
+    model="claude-3-5-haiku",
+    timeout=30
+)
+
+# Use the client
+response = client.query("What is the essence of learning?")
+```
+
+## Core Components
+
+- **Client**: Main interface for interacting
+- **Providers**: Provider-specific implementations
+- **Models**: Model definitions and configurations
+- **Async Client**: Asynchronous version
+- **Exceptions**: Custom error handling
+
+## Architecture Overview
+
+socrates-nexus follows a modular, layered architecture:
+
+- **Client Layer**: Public API for external consumers
+- **Processing Layer**: Core business logic and algorithms
+- **Integration Layer**: Connections to external services and APIs
+- **Data Layer**: State management and data persistence
+
+## Integration with Socratic Ecosystem
+
+socrates-nexus integrates seamlessly with:
+
+- **socrates-nexus**: Unified LLM provider interface
+- **socratic-rag**: Knowledge retrieval and augmentation
+- **socratic-core**: Common utilities and base classes
+- **Other ecosystem components**: As needed for specific use cases
+
+## Dependencies
+
+```
+- anthropic
+- openai
+- google-generativeai
+- langchain
+```
+
+## Performance Considerations
+
+- **Caching**: Intelligent caching for frequently accessed data
+- **Async Support**: Full async/await support for non-blocking I/O
+- **Scalability**: Designed for high-concurrency scenarios
+- **Resource Efficiency**: Optimized memory and CPU usage
+
+## Error Handling
+
+The library provides comprehensive error handling:
+
+```python
+from socrates_nexus import Client, Error
+
+try:
+    client = Client()
+    result = client.process()
+except Error as e:
+    print(f"Error: {e}")
+```
+
+## Testing
+
+Run the test suite:
+
+```bash
+pytest tests/
+```
+
+With coverage reporting:
+
+```bash
+pytest --cov=socrates_nexus tests/
+```
+
+## API Reference
+
+For complete API documentation, see [ARCHITECTURE.md](ARCHITECTURE.md)
+
+## Contributing
+
+Contributions are welcome! See CONTRIBUTING.md for guidelines.
+
+## Support & Resources
+
+- GitHub Issues: https://github.com/socratic-ai/socrates-nexus/issues
+- Documentation: https://socratic-docs.readthedocs.io/socrates-nexus
+- Discussions: https://github.com/socratic-ai/socrates-nexus/discussions
+
+## License
+
+MIT License - See LICENSE file for details
+
+---
+
+Part of the Socratic Ecosystem

socratic_nexus-0.3.1/README.md

@@ -0,0 +1,163 @@
+# Socratic Nexus (socrates-nexus)
+
+Universal LLM abstraction layer providing unified access to multiple AI providers
+
+## Overview
+
+socrates-nexus is a specialized component of the Socratic ecosystem that provides comprehensive functionality for universal llm abstraction layer providing unified access to multiple ai providers. It offers a production-ready, well-tested solution for integrating into larger Socratic systems.
+
+## Key Features
+
+- Multi-provider support
+- Unified client interface
+- Async/sync API support
+- Model standardization
+
+## Installation
+
+### Prerequisites
+- Python 3.8+
+- pip or poetry package manager
+
+### Via pip
+
+```bash
+pip install socrates-nexus
+```
+
+### Via poetry
+
+```bash
+poetry add socrates-nexus
+```
+
+### From source
+
+```bash
+git clone https://github.com/socratic-ai/socrates-nexus.git
+cd socrates-nexus
+pip install -e .
+```
+
+## Quick Start
+
+### Basic Usage
+
+```python
+from socrates_nexus import Client
+
+# Initialize the component
+client = Client()
+
+# Perform basic operation
+result = client.process()
+print(result)
+```
+
+### Configuration
+
+```python
+from socrates_nexus import Client
+
+# Configure with custom settings
+client = Client(
+    api_key="your-api-key",
+    model="claude-3-5-haiku",
+    timeout=30
+)
+
+# Use the client
+response = client.query("What is the essence of learning?")
+```
+
+## Core Components
+
+- **Client**: Main interface for interacting
+- **Providers**: Provider-specific implementations
+- **Models**: Model definitions and configurations
+- **Async Client**: Asynchronous version
+- **Exceptions**: Custom error handling
+
+## Architecture Overview
+
+socrates-nexus follows a modular, layered architecture:
+
+- **Client Layer**: Public API for external consumers
+- **Processing Layer**: Core business logic and algorithms
+- **Integration Layer**: Connections to external services and APIs
+- **Data Layer**: State management and data persistence
+
+## Integration with Socratic Ecosystem
+
+socrates-nexus integrates seamlessly with:
+
+- **socrates-nexus**: Unified LLM provider interface
+- **socratic-rag**: Knowledge retrieval and augmentation
+- **socratic-core**: Common utilities and base classes
+- **Other ecosystem components**: As needed for specific use cases
+
+## Dependencies
+
+```
+- anthropic
+- openai
+- google-generativeai
+- langchain
+```
+
+## Performance Considerations
+
+- **Caching**: Intelligent caching for frequently accessed data
+- **Async Support**: Full async/await support for non-blocking I/O
+- **Scalability**: Designed for high-concurrency scenarios
+- **Resource Efficiency**: Optimized memory and CPU usage
+
+## Error Handling
+
+The library provides comprehensive error handling:
+
+```python
+from socrates_nexus import Client, Error
+
+try:
+    client = Client()
+    result = client.process()
+except Error as e:
+    print(f"Error: {e}")
+```
+
+## Testing
+
+Run the test suite:
+
+```bash
+pytest tests/
+```
+
+With coverage reporting:
+
+```bash
+pytest --cov=socrates_nexus tests/
+```
+
+## API Reference
+
+For complete API documentation, see [ARCHITECTURE.md](ARCHITECTURE.md)
+
+## Contributing
+
+Contributions are welcome! See CONTRIBUTING.md for guidelines.
+
+## Support & Resources
+
+- GitHub Issues: https://github.com/socratic-ai/socrates-nexus/issues
+- Documentation: https://socratic-docs.readthedocs.io/socrates-nexus
+- Discussions: https://github.com/socratic-ai/socrates-nexus/discussions
+
+## License
+
+MIT License - See LICENSE file for details
+
+---
+
+Part of the Socratic Ecosystem

socratic_nexus-0.3.1/pyproject.toml

@@ -0,0 +1,164 @@
+[build-system]
+requires = ["setuptools>=65.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "socratic-nexus"
+version = "0.3.1"
+description = "Universal LLM client for production - works with Claude, GPT-4, Gemini, Llama, and any LLM. Built-in integrations with Openclaw and LangChain."
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Socrates Nexus Contributors"}
+]
+keywords = [
+    "llm",
+    "ai",
+    "claude",
+    "gpt-4",
+    "gemini",
+    "ollama",
+    "llama",
+    "production",
+    "multi-llm",
+    "universal-client",
+    "retry",
+    "streaming",
+    "async",
+    "token-tracking"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+requires-python = ">=3.9"
+
+dependencies = [
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+# Providers
+anthropic = ["anthropic>=0.40.0"]
+openai = ["openai>=1.0.0"]
+google = ["google-generativeai>=0.1.0rc1"]
+ollama = ["ollama>=0.0.8"]
+huggingface = ["huggingface-hub>=0.17.0"]
+
+# Integrations
+openclaw = []
+langchain = ["langchain>=0.1.0"]
+
+# All providers
+all = [
+    "anthropic>=0.40.0",
+    "openai>=1.0.0",
+    "ollama>=0.0.8",
+    "huggingface-hub>=0.17.0",
+]
+
+# All integrations
+integrations = [
+    "langchain>=0.1.0",
+]
+
+# Everything
+full = [
+    "anthropic>=0.40.0",
+    "openai>=1.0.0",
+    "google-generativeai>=0.3.0",
+    "ollama>=0.0.8",
+    "huggingface-hub>=0.17.0",
+    "langchain>=0.1.0",
+]
+
+async = ["asyncio>=3.4.3"]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0",
+    "black>=23.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Nireus79/socrates-nexus"
+Documentation = "https://github.com/Nireus79/socrates-nexus/tree/main/docs"
+Repository = "https://github.com/Nireus79/socrates-nexus"
+"Source Code" = "https://github.com/Nireus79/socrates-nexus"
+"Bug Tracker" = "https://github.com/Nireus79/socrates-nexus/issues"
+Changelog = "https://github.com/Nireus79/socrates-nexus/releases"
+
+[tool.setuptools]
+packages = [
+    "socrates_nexus",
+    "socrates_nexus.providers",
+    "socrates_nexus.utils",
+    "socrates_nexus.integrations",
+    "socrates_nexus.integrations.openclaw",
+    "socrates_nexus.integrations.langchain",
+]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.setuptools.package-data]
+socrates_nexus = ["py.typed"]
+
+[tool.black]
+line-length = 100
+target-version = ['py38']
+
+[tool.ruff]
+line-length = 100
+target-version = "py38"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+addopts = "--strict-markers --tb=short -v"
+markers = [
+    "unit: Unit tests (no external dependencies)",
+    "integration: Integration tests (require API keys)",
+    "slow: Tests that take >1 second",
+    "requires_api: Tests requiring valid API keys",
+]
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = false
+warn_unused_configs = true
+ignore_missing_imports = true
+disallow_incomplete_defs = false
+disallow_untyped_defs = false
+check_untyped_defs = false
+strict_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+plugins = ["pydantic.mypy"]
+
+[[tool.mypy.overrides]]
+module = [
+    "socrates_nexus.integrations.*",
+    "tests.*",
+]
+ignore_errors = true
+
+[tool.coverage.run]
+source = ["socrates_nexus"]
+branch = true
+omit = [
+    "*/tests/*",
+    "*/test_*.py",
+    "*/__init__.py",
+]

socratic_nexus-0.3.1/setup.cfg

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

socratic_nexus-0.3.1/src/socrates_nexus/__init__.py

@@ -0,0 +1,89 @@
+"""
+Socrates Nexus - Universal LLM client for production.
+
+Works with Claude, GPT-4, Gemini, Llama, and any LLM with production patterns:
+- Automatic retry logic with exponential backoff
+- Token usage tracking and cost calculation
+- Streaming support with helpers
+- Async + sync APIs
+- Multi-model fallback
+- Type hints throughout
+"""
+
+__version__ = "0.1.0"
+__author__ = "Socrates Nexus Contributors"
+
+from .client import LLMClient
+from .async_client import AsyncLLMClient
+from .documentation import (
+    APIDocumentation,
+    APIDocumentationGenerator,
+    EndpointDoc,
+    ParameterDoc,
+)
+from .performance import (
+    CostOptimizer,
+    InferenceOptimizer,
+    LatencyOptimizer,
+    ModelOptimizationConfig,
+    OptimizationResult,
+    PerformanceMetrics,
+)
+from .deduplication import (
+    RequestDeduplicator,
+    RequestBatcher,
+    CachedResponse,
+)
+from .models import ChatResponse, TokenUsage, LLMConfig, ImageContent, TextContent
+from .exceptions import (
+    LLMError,
+    NexusError,
+    RateLimitError,
+    AuthenticationError,
+    InvalidAPIKeyError,
+    TimeoutError,
+    ContextLengthExceededError,
+    ModelNotFoundError,
+    ProviderError,
+)
+from .vision import VisionMessage, VisionProcessor, VisionCapabilities
+
+__all__ = [
+    "LLMClient",
+    "AsyncLLMClient",
+    "ChatResponse",
+    "TokenUsage",
+    "LLMConfig",
+    "ImageContent",
+    "TextContent",
+    # Vision support
+    "VisionMessage",
+    "VisionProcessor",
+    "VisionCapabilities",
+    # Documentation
+    "APIDocumentation",
+    "APIDocumentationGenerator",
+    "EndpointDoc",
+    "ParameterDoc",
+    # Performance Optimization
+    "InferenceOptimizer",
+    "LatencyOptimizer",
+    "CostOptimizer",
+    "ModelOptimizationConfig",
+    "PerformanceMetrics",
+    "OptimizationResult",
+    # Request Deduplication & Batching
+    "RequestDeduplicator",
+    "RequestBatcher",
+    "CachedResponse",
+    # Exceptions
+    "LLMError",
+    "NexusError",
+    "RateLimitError",
+    "AuthenticationError",
+    "InvalidAPIKeyError",
+    "TimeoutError",
+    "ContextLengthExceededError",
+    "ModelNotFoundError",
+    "ProviderError",
+]