agentium 1.0.0__tar.gz

agentium-1.0.0/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: agentium
+Version: 1.0.0
+Summary: A comprehensive toolkit for AI agent development and workflow orchestration
+Home-page: https://github.com/RNSsanjay/Agentium-Python-Library
+Author: Sanjay N
+Author-email: 2005sanjaynrs@gmail.com
+Keywords: ai,agents,langchain,langgraph,crewai,nlp,automation,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: asyncio-throttle>=1.0.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: anthropic>=0.3.0
+Requires-Dist: google-generativeai>=0.3.0
+Requires-Dist: tiktoken>=0.4.0
+Requires-Dist: beautifulsoup4>=4.9.0
+Requires-Dist: lxml>=4.6.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: Jinja2>=3.0.0
+Requires-Dist: redis>=4.0.0
+Requires-Dist: sqlite3
+Requires-Dist: logging
+Requires-Dist: json5>=0.9.0
+Requires-Dist: dateutil>=2.8.0
+Requires-Dist: textstat>=0.7.0
+Requires-Dist: scikit-learn>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=22.0; extra == "dev"
+Requires-Dist: flake8>=5.0; extra == "dev"
+Requires-Dist: mypy>=0.991; extra == "dev"
+Provides-Extra: langchain
+Requires-Dist: langchain>=0.1.0; extra == "langchain"
+Requires-Dist: langchain-community>=0.0.10; extra == "langchain"
+Provides-Extra: langgraph
+Requires-Dist: langgraph>=0.0.20; extra == "langgraph"
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.1.0; extra == "crewai"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Agentium - AI Agent Development Toolkit
+
+[![PyPI version](https://badge.fury.io/py/agentium.svg)](https://badge.fury.io/py/agentium)
+[![Python Support](https://img.shields.io/pypi/pyversions/agentium.svg)](https://pypi.org/project/agentium/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A comprehensive Python library designed for AI agent development and workflow orchestration. Agentium provides a rich set of tools and utilities that seamlessly integrate with popular AI frameworks like LangChain, LangGraph, and CrewAI.
+
+## Features
+
+- **🗜️ Condense**: Intelligent content condensation and compression
+- **⚡ Optimizer**: Refine text, code, and workflows for better performance
+- **📋 Rearranger**: Organize and restructure content logically
+- **🔍 Extractor**: Extract structured information from various data sources
+- **📢 Communicator**: Send messages and notifications across platforms
+- **🌐 Translator**: Multi-language translation with tone adaptation
+- **💡 Insight Generator**: Generate actionable insights from data
+- **🔄 Workflow Helper**: Orchestrate complex tasks and triggers
+- **📄 Template Manager**: Standardize outputs with customizable templates
+- **🧠 Memory Helper**: Context storage and retrieval system
+- **📝 Custom Summarizer**: Create summaries tailored to specific needs
+- **📊 Logger Utils**: Track and debug operations with detailed logging
+
+## Installation
+
+```bash
+pip install agentium
+```
+
+### Framework-specific installations:
+
+```bash
+# For LangChain integration
+pip install agentium[langchain]
+
+# For LangGraph integration
+pip install agentium[langgraph]
+
+# For CrewAI integration
+pip install agentium[crewai]
+
+# For development
+pip install agentium[dev]
+```
+
+## Quick Start
+
+```python
+from agentium import Condenser, Optimizer, Communicator
+
+# Initialize components
+condenser = Condenser()
+optimizer = Optimizer()
+communicator = Communicator()
+
+# Condense text
+condensed = condenser.condense("Your long text here...")
+
+# Optimize content
+optimized = optimizer.optimize_text("Text to optimize")
+
+# Send notification
+communicator.send_notification("Process completed!", channel="email")
+```
+
+## Framework Integration
+
+### LangChain Integration
+
+```python
+from agentium.integrations.langchain import AgentiumTool
+from langchain.agents import initialize_agent
+
+# Create Agentium tools for LangChain
+tools = AgentiumTool.create_all_tools()
+agent = initialize_agent(tools, llm, agent_type="zero-shot-react-description")
+```
+
+### LangGraph Integration
+
+```python
+from agentium.integrations.langgraph import AgentiumNode
+from langgraph import Graph
+
+# Add Agentium nodes to LangGraph
+graph = Graph()
+graph.add_node("condenser", AgentiumNode.condenser_node)
+graph.add_node("optimizer", AgentiumNode.optimizer_node)
+```
+
+### CrewAI Integration
+
+```python
+from agentium.integrations.crewai import AgentiumCrewTool
+from crewai import Agent, Task, Crew
+
+# Create tools for CrewAI agents
+tools = AgentiumCrewTool.get_all_tools()
+agent = Agent(tools=tools, ...)
+```
+
+## Documentation
+
+For detailed documentation and examples, visit [our documentation site](https://agentium.readthedocs.io).
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+If you encounter any issues or have questions, please [open an issue](https://github.com/RNSsanjay/Agentium-Python-Library/issues) on GitHub.

agentium-1.0.0/README.md

@@ -0,0 +1,116 @@
+# Agentium - AI Agent Development Toolkit
+
+[![PyPI version](https://badge.fury.io/py/agentium.svg)](https://badge.fury.io/py/agentium)
+[![Python Support](https://img.shields.io/pypi/pyversions/agentium.svg)](https://pypi.org/project/agentium/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A comprehensive Python library designed for AI agent development and workflow orchestration. Agentium provides a rich set of tools and utilities that seamlessly integrate with popular AI frameworks like LangChain, LangGraph, and CrewAI.
+
+## Features
+
+- **🗜️ Condense**: Intelligent content condensation and compression
+- **⚡ Optimizer**: Refine text, code, and workflows for better performance
+- **📋 Rearranger**: Organize and restructure content logically
+- **🔍 Extractor**: Extract structured information from various data sources
+- **📢 Communicator**: Send messages and notifications across platforms
+- **🌐 Translator**: Multi-language translation with tone adaptation
+- **💡 Insight Generator**: Generate actionable insights from data
+- **🔄 Workflow Helper**: Orchestrate complex tasks and triggers
+- **📄 Template Manager**: Standardize outputs with customizable templates
+- **🧠 Memory Helper**: Context storage and retrieval system
+- **📝 Custom Summarizer**: Create summaries tailored to specific needs
+- **📊 Logger Utils**: Track and debug operations with detailed logging
+
+## Installation
+
+```bash
+pip install agentium
+```
+
+### Framework-specific installations:
+
+```bash
+# For LangChain integration
+pip install agentium[langchain]
+
+# For LangGraph integration
+pip install agentium[langgraph]
+
+# For CrewAI integration
+pip install agentium[crewai]
+
+# For development
+pip install agentium[dev]
+```
+
+## Quick Start
+
+```python
+from agentium import Condenser, Optimizer, Communicator
+
+# Initialize components
+condenser = Condenser()
+optimizer = Optimizer()
+communicator = Communicator()
+
+# Condense text
+condensed = condenser.condense("Your long text here...")
+
+# Optimize content
+optimized = optimizer.optimize_text("Text to optimize")
+
+# Send notification
+communicator.send_notification("Process completed!", channel="email")
+```
+
+## Framework Integration
+
+### LangChain Integration
+
+```python
+from agentium.integrations.langchain import AgentiumTool
+from langchain.agents import initialize_agent
+
+# Create Agentium tools for LangChain
+tools = AgentiumTool.create_all_tools()
+agent = initialize_agent(tools, llm, agent_type="zero-shot-react-description")
+```
+
+### LangGraph Integration
+
+```python
+from agentium.integrations.langgraph import AgentiumNode
+from langgraph import Graph
+
+# Add Agentium nodes to LangGraph
+graph = Graph()
+graph.add_node("condenser", AgentiumNode.condenser_node)
+graph.add_node("optimizer", AgentiumNode.optimizer_node)
+```
+
+### CrewAI Integration
+
+```python
+from agentium.integrations.crewai import AgentiumCrewTool
+from crewai import Agent, Task, Crew
+
+# Create tools for CrewAI agents
+tools = AgentiumCrewTool.get_all_tools()
+agent = Agent(tools=tools, ...)
+```
+
+## Documentation
+
+For detailed documentation and examples, visit [our documentation site](https://agentium.readthedocs.io).
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+If you encounter any issues or have questions, please [open an issue](https://github.com/RNSsanjay/Agentium-Python-Library/issues) on GitHub.

agentium-1.0.0/agentium/__init__.py

@@ -0,0 +1,297 @@
+"""
+Agentium - Comprehensive Python Library for AI Agent Development
+
+A production-ready library providing essential tools and utilities for 
+building intelligent AI agents, compatible with LangChain, LangGraph, and CrewAI.
+
+Core Features:
+- Content condensation and optimization
+- Data extraction and processing  
+- Multi-channel communication
+- Translation and localization
+- Insight generation and analysis
+- Workflow orchestration
+- Template management
+- Memory and context storage
+- Custom summarization
+- Advanced logging and monitoring
+
+Framework Integrations:
+- LangChain: Tools, memory, parsers, callbacks
+- LangGraph: Workflow nodes, state management
+- CrewAI: Enhanced agents, tasks, crews
+"""
+
+__version__ = "1.0.0"
+__author__ = "Agentium Development Team"
+__license__ = "MIT"
+
+# Core components
+from .core.condenser import Condenser, CondenserConfig
+from .core.optimizer import Optimizer, OptimizerConfig  
+from .core.rearranger import Rearranger, RearrangerConfig
+from .core.extractor import Extractor, ExtractorConfig
+from .core.communicator import Communicator, CommunicatorConfig
+from .core.translator import Translator, TranslatorConfig
+from .core.insight_generator import InsightGenerator, InsightConfig
+from .core.workflow_helper import WorkflowHelper, WorkflowConfig
+from .core.template_manager import TemplateManager, TemplateConfig
+from .core.memory_helper import MemoryHelper, MemoryConfig
+from .core.summarize_custom import CustomSummarizer, SummaryConfig
+
+# Utilities
+from .utils.logger_utils import LoggerUtils, LoggerConfig
+
+# Integrations (with optional imports)
+try:
+    from .integrations.langchain import (
+        get_agentium_langchain_integration,
+        AgentiumLangChainIntegration,
+        AgentiumMemory,
+        AgentiumOutputParser,
+        AgentiumCallbackHandler
+    )
+    LANGCHAIN_INTEGRATION_AVAILABLE = True
+except Exception:
+    LANGCHAIN_INTEGRATION_AVAILABLE = False
+
+try:
+    from .integrations.langgraph import (
+        get_agentium_langgraph_integration,
+        AgentiumLangGraphIntegration,
+        AgentiumLangGraphBuilder,
+        AgentiumLangGraphWorkflow
+    )
+    LANGGRAPH_INTEGRATION_AVAILABLE = True
+except Exception:
+    LANGGRAPH_INTEGRATION_AVAILABLE = False
+
+try:
+    from .integrations.crewai import (
+        get_agentium_crewai_integration,
+        AgentiumCrewAIIntegration,
+        AgentiumCrewAIAgent,
+        AgentiumCrewAITask,
+        AgentiumCrewAICrew
+    )
+    CREWAI_INTEGRATION_AVAILABLE = True
+except Exception:
+    CREWAI_INTEGRATION_AVAILABLE = False
+
+# Main exports
+__all__ = [
+    # Version and metadata
+    '__version__',
+    '__author__',
+    '__license__',
+    
+    # Core components
+    'Condenser',
+    'CondenserConfig',
+    'Optimizer', 
+    'OptimizerConfig',
+    'Rearranger',
+    'RearrangerConfig',
+    'Extractor',
+    'ExtractorConfig',
+    'Communicator',
+    'CommunicatorConfig',
+    'Translator',
+    'TranslatorConfig',
+    'InsightGenerator',
+    'InsightConfig',
+    'WorkflowHelper',
+    'WorkflowConfig',
+    'TemplateManager',
+    'TemplateConfig',
+    'MemoryHelper',
+    'MemoryConfig',
+    'CustomSummarizer',
+    'SummaryConfig',
+    
+    # Utilities
+    'LoggerUtils',
+    'LoggerConfig',
+    
+    # Integration flags
+    'LANGCHAIN_INTEGRATION_AVAILABLE',
+    'LANGGRAPH_INTEGRATION_AVAILABLE', 
+    'CREWAI_INTEGRATION_AVAILABLE',
+]
+
+# Add integration exports if available
+if LANGCHAIN_INTEGRATION_AVAILABLE:
+    __all__.extend([
+        'get_agentium_langchain_integration',
+        'AgentiumLangChainIntegration',
+        'AgentiumMemory',
+        'AgentiumOutputParser',
+        'AgentiumCallbackHandler'
+    ])
+
+if LANGGRAPH_INTEGRATION_AVAILABLE:
+    __all__.extend([
+        'get_agentium_langgraph_integration',
+        'AgentiumLangGraphIntegration',
+        'AgentiumLangGraphBuilder',
+        'AgentiumLangGraphWorkflow'
+    ])
+
+if CREWAI_INTEGRATION_AVAILABLE:
+    __all__.extend([
+        'get_agentium_crewai_integration',
+        'AgentiumCrewAIIntegration',
+        'AgentiumCrewAIAgent',
+        'AgentiumCrewAITask',
+        'AgentiumCrewAICrew'
+    ])
+
+from typing import Optional, Dict, Any
+
+
+class Agentium:
+    """
+    Main Agentium class providing unified access to all components.
+    
+    This class serves as a convenient entry point for accessing all
+    Agentium functionality in a single interface.
+    """
+    
+    def __init__(self, logger_config: Optional[LoggerConfig] = None):
+        """Initialize Agentium with optional logging configuration"""
+        self.logger = LoggerUtils.get_logger(__name__)
+        
+        if logger_config:
+            LoggerUtils.configure(logger_config)
+        
+        # Initialize core components
+        self.condenser = Condenser()
+        self.optimizer = Optimizer()
+        self.rearranger = Rearranger()
+        self.extractor = Extractor()
+        self.communicator = Communicator()
+        self.translator = Translator()
+        self.insight_generator = InsightGenerator()
+        self.workflow_helper = WorkflowHelper()
+        self.template_manager = TemplateManager()
+        self.memory_helper = MemoryHelper()
+        self.summarizer = CustomSummarizer()
+        
+        # Initialize integrations
+        self._init_integrations()
+        
+        self.logger.info("Agentium initialized with all core components")
+    
+    def _init_integrations(self):
+        """Initialize framework integrations"""
+        self.langchain_integration = None
+        self.langgraph_integration = None
+        self.crewai_integration = None
+        
+        if LANGCHAIN_INTEGRATION_AVAILABLE:
+            try:
+                self.langchain_integration = get_agentium_langchain_integration()
+                self.logger.info("LangChain integration initialized")
+            except Exception as e:
+                self.logger.warning(f"Failed to initialize LangChain integration: {e}")
+        
+        if LANGGRAPH_INTEGRATION_AVAILABLE:
+            try:
+                self.langgraph_integration = get_agentium_langgraph_integration()
+                self.logger.info("LangGraph integration initialized")
+            except Exception as e:
+                self.logger.warning(f"Failed to initialize LangGraph integration: {e}")
+        
+        if CREWAI_INTEGRATION_AVAILABLE:
+            try:
+                self.crewai_integration = get_agentium_crewai_integration()
+                self.logger.info("CrewAI integration initialized")
+            except Exception as e:
+                self.logger.warning(f"Failed to initialize CrewAI integration: {e}")
+    
+    def get_integration_status(self) -> Dict[str, bool]:
+        """Get the status of all integrations"""
+        return {
+            'langchain': LANGCHAIN_INTEGRATION_AVAILABLE and self.langchain_integration is not None,
+            'langgraph': LANGGRAPH_INTEGRATION_AVAILABLE and self.langgraph_integration is not None,
+            'crewai': CREWAI_INTEGRATION_AVAILABLE and self.crewai_integration is not None,
+        }
+    
+    def process_content(self, content: str, workflow: str = "basic") -> Dict[str, Any]:
+        """
+        Process content through a predefined workflow
+        
+        Available workflows:
+        - basic: condense -> optimize -> summarize
+        - analysis: extract -> insights -> summarize  
+        - translation: translate -> optimize -> summarize
+        """
+        
+        results = {'workflow': workflow, 'steps': []}
+        
+        try:
+            if workflow == "basic":
+                # Condense -> Optimize -> Summarize
+                condensed_result = self.condenser.condense(content)
+                condensed_text = condensed_result.get('text') if isinstance(condensed_result, dict) else condensed_result
+                results['steps'].append({'step': 'condense', 'result': condensed_result})
+                
+                optimized_result = self.optimizer.optimize(condensed_text)
+                optimized_text = optimized_result.get('text') if isinstance(optimized_result, dict) else optimized_result
+                results['steps'].append({'step': 'optimize', 'result': optimized_result})
+                
+                summarized_result = self.summarizer.summarize(optimized_text)
+                summarized = summarized_result if isinstance(summarized_result, dict) else {'summary': summarized_result}
+                results['steps'].append({'step': 'summarize', 'result': summarized})
+                
+                results['final_output'] = summarized.get('summary', str(summarized))
+                
+            elif workflow == "analysis":
+                # Extract -> Insights -> Summarize
+                extracted_result = self.extractor.extract(content)
+                extracted = extracted_result if isinstance(extracted_result, dict) else {'extracted_data': extracted_result}
+                results['steps'].append({'step': 'extract', 'result': extracted})
+                
+                insights_result = self.insight_generator.generate_insights(str(extracted['extracted_data']))
+                insights = insights_result if isinstance(insights_result, dict) else {'insights': insights_result}
+                results['steps'].append({'step': 'insights', 'result': insights})
+                
+                data_str = str(extracted['extracted_data'])
+                insights_str = str(insights.get('insights', insights))
+                summarized_result = self.summarizer.summarize(f"Data: {data_str} Insights: {insights_str}")
+                summarized = summarized_result if isinstance(summarized_result, dict) else {'summary': summarized_result}
+                results['steps'].append({'step': 'summarize', 'result': summarized})
+                
+                results['final_output'] = summarized.get('summary', str(summarized))
+                
+            elif workflow == "translation":
+                # Translate -> Optimize -> Summarize  
+                translated_result = self.translator.translate(content)
+                translated = translated_result if isinstance(translated_result, dict) else {'translated_text': translated_result}
+                results['steps'].append({'step': 'translate', 'result': translated})
+                
+                optimized_result = self.optimizer.optimize(translated['translated_text'])
+                optimized = optimized_result if isinstance(optimized_result, dict) else {'optimized_content': optimized_result}
+                results['steps'].append({'step': 'optimize', 'result': optimized})
+                
+                summarized_result = self.summarizer.summarize(optimized['optimized_content'])
+                summarized = summarized_result if isinstance(summarized_result, dict) else {'summary': summarized_result}
+                results['steps'].append({'step': 'summarize', 'result': summarized})
+                
+                results['final_output'] = summarized.get('summary', str(summarized))
+                
+            else:
+                raise ValueError(f"Unknown workflow: {workflow}")
+                
+            results['success'] = True
+            
+        except Exception as e:
+            results['success'] = False
+            results['error'] = str(e)
+            self.logger.error(f"Workflow {workflow} failed: {e}")
+        
+        return results
+
+
+# Add to main exports
+__all__.extend(['Agentium'])

agentium-1.0.0/agentium/core/__init__.py

@@ -0,0 +1 @@
+# Core package initialization