gaik 0.2.7__py3-none-any.whl

gaik/providers/openai.py

@@ -0,0 +1,51 @@
+"""OpenAI provider implementation."""
+
+from typing import Any
+
+from langchain_core.language_models import BaseChatModel
+from langchain_openai import ChatOpenAI
+
+from .base import LLMProvider, _build_model_kwargs
+
+
+class OpenAIProvider(LLMProvider):
+    """OpenAI LLM provider using LangChain's ChatOpenAI.
+
+    Supports OpenAI's GPT models including GPT-4, GPT-4 Turbo, and GPT-3.5.
+    Requires OPENAI_API_KEY environment variable or api_key parameter.
+    """
+
+    @property
+    def default_model(self) -> str:
+        """Return OpenAI's default model.
+
+        Returns:
+            str: "gpt-4.1"
+        """
+        return "gpt-4.1"
+
+    def create_chat_model(
+        self,
+        model: str | None = None,
+        api_key: str | None = None,
+        **kwargs: Any,
+    ) -> BaseChatModel:
+        """Create OpenAI chat model instance.
+
+        Args:
+            model: Model name (e.g., "gpt-4.1", "gpt-4o", "gpt-3.5-turbo").
+                   Defaults to "gpt-4.1".
+            api_key: OpenAI API key. If None, uses OPENAI_API_KEY environment variable.
+            **kwargs: Additional parameters passed to ChatOpenAI (e.g., temperature, max_tokens).
+
+        Returns:
+            ChatOpenAI: Configured OpenAI chat model
+
+        Example:
+            >>> provider = OpenAIProvider()
+            >>> model = provider.create_chat_model(model="gpt-4o", temperature=0.7)
+        """
+        model_kwargs = _build_model_kwargs(
+            model=model or self.default_model, api_key=api_key, **kwargs
+        )
+        return ChatOpenAI(**model_kwargs)

gaik-0.2.7.dist-info/METADATA

@@ -0,0 +1,278 @@
+Metadata-Version: 2.4
+Name: gaik
+Version: 0.2.7
+Summary: General AI Kit - Reusable AI/ML components for Python
+Author: GAIK Project
+License: MIT License
+        
+        Copyright (c) 2025 GAIK - GenAI for knowledge mgt
+        
+        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.
+        
+Project-URL: Homepage, https://gaik.ai/
+Project-URL: Repository, https://github.com/GAIK-project/toolkit-shared-components
+Project-URL: Documentation, https://github.com/GAIK-project/toolkit-shared-components/tree/main/gaik-py
+Project-URL: Issues, https://github.com/GAIK-project/toolkit-shared-components/issues
+Keywords: ai,ml,langchain,openai,anthropic,google,structured-outputs,pydantic,schema,extraction
+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.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.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.12.3
+Requires-Dist: langchain-core>=1.0.3
+Requires-Dist: langchain-openai>=1.0.2
+Requires-Dist: langchain-anthropic>=1.0.1
+Requires-Dist: langchain-google-genai>=3.0.1
+Provides-Extra: dev
+Requires-Dist: ruff>=0.14.1; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Provides-Extra: vision
+Requires-Dist: openai>=1.40.0; extra == "vision"
+Requires-Dist: pdf2image>=1.17.0; extra == "vision"
+Requires-Dist: pillow>=10.0.0; extra == "vision"
+Requires-Dist: python-dotenv>=1.0.0; extra == "vision"
+Dynamic: license-file
+
+# GAIK - General AI Kit
+
+**Reusable AI/ML components for Python**
+
+Multi-provider AI toolkit for structured data extraction. Supports OpenAI, Anthropic Claude, Google Gemini, and Azure OpenAI.
+
+## Features
+
+### 🔍 Dynamic Data Extraction (`gaik.extract`)
+
+Extract structured data from unstructured text using LangChain's structured outputs:
+
+- ✅ **Multi-provider** - OpenAI, Anthropic, Azure, Google - easy switching
+- ✅ **Guaranteed structure** - API-enforced schema compliance
+- ✅ **Type-safe** - Full Pydantic validation
+- ✅ **No code generation** - Uses Pydantic's `create_model()`, no `eval()`
+- ✅ **Cost-effective** - Minimal API calls
+- ✅ **Simple & clean** - Easy to understand, minimal dependencies
+
+### 🖼️ Vision PDF Parsing (`gaik.parsers`)
+
+Convert PDF pages to Markdown with OpenAI or Azure OpenAI vision models:
+
+- ✅ **Single API surface** - Works with standard OpenAI or Azure deployments
+- ✅ **Optional extras** - Install with `pip install gaik[vision]`
+- ✅ **CLI ready** - See `examples/demo_vision_parser.py` for quick conversions
+- ✅ **Table-aware** - Keeps multi-page tables intact with optional cleanup
+
+## Installation
+
+```bash
+# From PyPI (production)
+pip install gaik
+
+# With optional vision parser support
+pip install gaik[vision]
+```
+
+## Quick Start
+
+### 1. Set up your provider API key
+
+**OpenAI (default):**
+
+```bash
+export OPENAI_API_KEY='sk-...'  # Get from: https://platform.openai.com/api-keys
+```
+
+**Anthropic:**
+
+```bash
+export ANTHROPIC_API_KEY='sk-ant-...'  # Get from: https://console.anthropic.com
+```
+
+**Google:**
+
+```bash
+export GOOGLE_API_KEY='...'  # Get from: https://ai.google.dev
+```
+
+**Azure OpenAI:**
+
+```bash
+export AZURE_API_KEY='...'
+export AZURE_ENDPOINT='https://your-resource.openai.azure.com/'
+```
+
+### 2. Simple Extraction
+
+```python
+from gaik.extract import SchemaExtractor
+
+# Using default OpenAI provider
+extractor = SchemaExtractor("Extract name and age from text")
+result = extractor.extract_one("Alice is 25 years old")
+print(result)
+# {'name': 'Alice', 'age': 25}
+
+# Switch to Anthropic Claude
+extractor = SchemaExtractor(
+    "Extract name and age from text",
+    provider="anthropic"
+)
+
+# Use Google Gemini
+extractor = SchemaExtractor(
+    "Extract name and age from text",
+    provider="google"
+)
+```
+
+### 3. Batch Extraction
+
+```python
+from gaik.extract import dynamic_extraction_workflow
+
+description = """
+Extract from invoices:
+- Invoice number
+- Total amount in USD
+- Vendor name
+"""
+
+documents = [
+    "Invoice #12345 from Acme Corp. Total: $1,500",
+    "INV-67890, Supplier: TechCo, Amount: $2,750"
+]
+
+# Use any provider
+results = dynamic_extraction_workflow(
+    description,
+    documents,
+    provider="openai"  # or "anthropic", "google", "azure"
+)
+
+for result in results:
+    print(f"Invoice: {result['invoice_number']}, Amount: ${result['total_amount']}")
+```
+
+### 4. Reusable Extractor (Recommended)
+
+```python
+from gaik.extract import SchemaExtractor
+
+# Create extractor once
+extractor = SchemaExtractor("""
+Extract from project reports:
+- Project title
+- Lead institution
+- Total funding in euros
+- List of partner countries
+""")
+
+# Reuse for multiple batches
+batch1_results = extractor.extract(documents_batch1)
+batch2_results = extractor.extract(documents_batch2)
+
+# Inspect the schema
+print(f"Fields: {extractor.field_names}")
+# ['project_title', 'lead_institution', 'total_funding', 'partner_countries']
+```
+
+### 5. Schema-Only Generation
+
+Generate Pydantic schemas without extraction:
+
+```python
+from gaik.extract import FieldSpec, ExtractionRequirements, create_extraction_model
+
+requirements = ExtractionRequirements(
+    use_case_name="Invoice",
+    fields=[
+        FieldSpec(
+            field_name="invoice_number",
+            field_type="str",
+            description="Invoice identifier",
+            required=True
+        ),
+        FieldSpec(
+            field_name="amount",
+            field_type="float",
+            description="Total amount",
+            required=True
+        )
+    ]
+)
+
+# Create Pydantic model
+InvoiceModel = create_extraction_model(requirements)
+schema = InvoiceModel.model_json_schema()
+```
+
+## API Reference
+
+| Function/Class                  | Purpose                                           |
+| ------------------------------- | ------------------------------------------------- |
+| `SchemaExtractor`               | Reusable extractor with provider selection        |
+| `dynamic_extraction_workflow()` | One-shot extraction from natural language         |
+| `create_extraction_model()`     | Generate Pydantic model from field specifications |
+| `FieldSpec`                     | Define a single extraction field                  |
+| `ExtractionRequirements`        | Collection of field specifications                |
+
+### Provider Parameters
+
+```python
+SchemaExtractor(
+    user_description: str | None = None,  # Optional if requirements provided
+    provider: Literal["openai", "anthropic", "google", "azure"] = "openai",
+    model: str | None = None,             # Optional: override default model
+    api_key: str | None = None,           # Optional: override env variable
+    client: BaseChatModel | None = None,  # Optional: custom LangChain client
+    requirements: ExtractionRequirements | None = None  # Optional: pre-defined schema
+)
+```
+
+**Note:**
+
+- IDEs with type checking (VS Code, PyCharm) will show autocomplete for `provider` parameter
+- Either `user_description` or `requirements` must be provided
+- Using `requirements` skips LLM parsing step (faster & cheaper)
+
+## Default Models
+
+- OpenAI: `gpt-4.1`
+- Anthropic: `claude-sonnet-4-5-20250929`
+- Google: `gemini-2.5-flash`
+- Azure: `gpt-4.1`
+
+## Resources
+
+- [GitHub Repository](https://github.com/GAIK-project/toolkit-shared-components)
+- [Examples Directory](https://github.com/GAIK-project/toolkit-shared-components/tree/main/examples)
+- [LangChain Documentation](https://python.langchain.com/docs/how_to/structured_output/)
+- [Pydantic Documentation](https://docs.pydantic.dev/)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.

gaik-0.2.7.dist-info/RECORD

@@ -0,0 +1,18 @@
+gaik/__init__.py,sha256=32Rg3auhijpgYZCk49LjlGClZkE1Sr5Y7bN0MDdo80Y,700
+gaik/extract/__init__.py,sha256=CukSVkXLn9BS7kjAYIXNZAvZjzXaPCEwGUAhH4V70oE,837
+gaik/extract/extractor.py,sha256=0aoSwi6weRIMigRpXbsMT30XVTpf9MuuOq8-A-21qtI,10836
+gaik/extract/models.py,sha256=cXxivZ72c6rm4DvS0q5zJpegeaL3q2CDJRsttGBzn_Q,1486
+gaik/extract/utils.py,sha256=vHwMQL_QcTybRRwrzECmLcMEei0qBzj69zXexdiermc,3737
+gaik/parsers/__init__.py,sha256=3pk3nDdKw9zO-YuPPKS3CmkBJ4EkP0RefbCtC9-778k,297
+gaik/parsers/vision.py,sha256=Ul1Lhdrvj8BfOXo3Qig0JKcKYMhcZOeWQY62Xu6SM08,13630
+gaik/providers/__init__.py,sha256=pb_ZANsRWZ1AQc5rwhmzpncp0ddlX5UFU0l-_coZho4,1764
+gaik/providers/anthropic.py,sha256=jvPafiAKlXTDa3tag-ohgvSACTy7Tvn4ZH3ZKcCiZSU,1791
+gaik/providers/azure.py,sha256=lRCn04v57BM0vDHNtb9Uc3lzumrL4p3J0VuWB8RS5lY,2161
+gaik/providers/base.py,sha256=upH3S0QbKQSEC99mOF48LtKFcK5g3TFyd0GVxVuvgUk,1885
+gaik/providers/google.py,sha256=t5p4uBb3v81KgZ-JQ7N7oKIS-0doCem1IV4VThfLKIY,1690
+gaik/providers/openai.py,sha256=OUyc_a01oNEqtMO8KnHZmwqJp_hEQQC1FXfXelNNGPU,1559
+gaik-0.2.7.dist-info/licenses/LICENSE,sha256=jE12SAuBnlcHf16GXD5xfZNtSH6ds30U5LniIt_gRis,1087
+gaik-0.2.7.dist-info/METADATA,sha256=6lYKHurKCQK8FVemsdxfKhZ8OTRjpjb9_c70M_UT9AU,9048
+gaik-0.2.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gaik-0.2.7.dist-info/top_level.txt,sha256=p-eYZovskBEyr7C7GfsXIYQta9-fGyUSaFYDTX8oky8,5
+gaik-0.2.7.dist-info/RECORD,,

gaik-0.2.7.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

gaik-0.2.7.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GAIK - GenAI for knowledge mgt
+
+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.

gaik-0.2.7.dist-info/top_level.txt

@@ -0,0 +1 @@
+gaik