sonika-langchain-bot 0.0.10__tar.gz → 0.0.12__tar.gz

sonika_langchain_bot-0.0.12/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: sonika-langchain-bot
+Version: 0.0.12
+Summary: Agente langchain con LLM
+Author: Erley Blanco Carvajal
+License: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: langchain-mcp-adapters==0.1.9
+Requires-Dist: langchain-community==0.3.26
+Requires-Dist: langchain-core==0.3.66
+Requires-Dist: langchain-openai==0.3.24
+Requires-Dist: langgraph==0.4.8
+Requires-Dist: langgraph-checkpoint==2.1.0
+Requires-Dist: langgraph-sdk==0.1.70
+Requires-Dist: dataclasses-json==0.6.7
+Requires-Dist: python-dateutil==2.9.0.post0
+Requires-Dist: pydantic==2.11.7
+Requires-Dist: faiss-cpu==1.11.0
+Requires-Dist: pypdf==5.6.1
+Requires-Dist: python-dotenv==1.0.1
+Requires-Dist: typing_extensions==4.14.0
+Requires-Dist: typing-inspect==0.9.0
+Provides-Extra: dev
+Requires-Dist: sphinx<9.0.0,>=8.1.3; extra == "dev"
+Requires-Dist: sphinx-rtd-theme<4.0.0,>=3.0.1; extra == "dev"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Sonika LangChain Bot <a href="https://pepy.tech/projects/sonika-langchain-bot"><img src="https://static.pepy.tech/badge/sonika-langchain-bot" alt="PyPI Downloads"></a>
+
+A Python library that implements a conversational agent using LangChain with tool execution capabilities and text classification.
+
+## Installation
+
+```bash
+pip install sonika-langchain-bot
+```
+
+## Prerequisites
+
+You'll need the following API keys:
+
+- OpenAI API Key
+
+Create a `.env` file in the root of your project with the following variables:
+
+```env
+OPENAI_API_KEY=your_api_key_here
+```
+
+## Key Features
+
+- Conversational agent with tool execution capabilities
+- Text classification with structured output
+- Custom tool integration
+- Streaming responses
+- Conversation history management
+- Flexible instruction-based behavior
+
+## Basic Usage
+
+### Agent with Tools Example
+
+```python
+import os
+from dotenv import load_dotenv
+from langchain_openai import OpenAIEmbeddings
+from sonika_langchain_bot.langchain_tools import EmailTool
+from sonika_langchain_bot.langchain_bot_agent import LangChainBot
+from sonika_langchain_bot.langchain_class import Message, ResponseModel
+from sonika_langchain_bot.langchain_models import OpenAILanguageModel
+
+# Load environment variables
+load_dotenv()
+
+# Get API key from .env file
+api_key = os.getenv("OPENAI_API_KEY")
+
+# Initialize language model and embeddings
+language_model = OpenAILanguageModel(api_key, model_name='gpt-4o-mini-2024-07-18', temperature=1)
+embeddings = OpenAIEmbeddings(api_key=api_key)
+
+# Configure tools
+tools = [EmailTool()]
+
+# Create agent instance
+bot = LangChainBot(language_model, embeddings, instructions="You are an agent", tools=tools)
+
+# Load conversation history
+bot.load_conversation_history([Message(content="My name is Erley", is_bot=False)])
+
+# Get response
+user_message = 'Send an email with the tool to erley@gmail.com with subject Hello and message Hello Erley'
+response_model: ResponseModel = bot.get_response(user_message)
+
+print(response_model)
+```
+
+### Streaming Response Example
+
+```python
+import os
+from dotenv import load_dotenv
+from langchain_openai import OpenAIEmbeddings
+from sonika_langchain_bot.langchain_bot_agent import LangChainBot
+from sonika_langchain_bot.langchain_class import Message
+from sonika_langchain_bot.langchain_models import OpenAILanguageModel
+
+# Load environment variables
+load_dotenv()
+
+# Get API key from .env file
+api_key = os.getenv("OPENAI_API_KEY")
+
+# Initialize language model and embeddings
+language_model = OpenAILanguageModel(api_key, model_name='gpt-4o-mini-2024-07-18', temperature=1)
+embeddings = OpenAIEmbeddings(api_key=api_key)
+
+# Create agent instance
+bot = LangChainBot(language_model, embeddings, instructions="Only answers in english", tools=[])
+
+# Load conversation history
+bot.load_conversation_history([Message(content="My name is Erley", is_bot=False)])
+
+# Get streaming response
+user_message = 'Hello, what is my name?'
+for chunk in bot.get_response_stream(user_message):
+    print(chunk)
+```
+
+### Text Classification Example
+
+```python
+import os
+from dotenv import load_dotenv
+from sonika_langchain_bot.langchain_clasificator import TextClassifier
+from sonika_langchain_bot.langchain_models import OpenAILanguageModel
+from pydantic import BaseModel, Field
+
+# Load environment variables
+load_dotenv()
+
+# Define classification structure with Pydantic
+class Classification(BaseModel):
+    intention: str = Field()
+    sentiment: str = Field(..., enum=["happy", "neutral", "sad", "excited"])
+    aggressiveness: int = Field(
+        ...,
+        description="describes how aggressive the statement is, the higher the number the more aggressive",
+        enum=[1, 2, 3, 4, 5],
+    )
+    language: str = Field(
+        ..., enum=["spanish", "english", "french", "german", "italian"]
+    )
+
+# Initialize classifier
+api_key = os.getenv("OPENAI_API_KEY")
+model = OpenAILanguageModel(api_key=api_key)
+classifier = TextClassifier(llm=model, validation_class=Classification)
+
+# Classify text
+result = classifier.classify("how are you?")
+print(result)
+```
+
+## Available Classes and Components
+
+### Core Classes
+
+- **LangChainBot**: Main conversational agent for task execution with tools
+- **OpenAILanguageModel**: Wrapper for OpenAI language models
+- **TextClassifier**: Text classification using structured output
+- **Message**: Message structure for conversation history
+- **ResponseModel**: Response structure from agent interactions
+
+### Tools
+
+- **EmailTool**: Tool for sending emails through the agent
+
+## Project Structure
+
+```
+your_project/
+├── .env                    # Environment variables
+├── src/
+│   └── sonika_langchain_bot/
+│       ├── langchain_bot_agent.py
+│       ├── langchain_clasificator.py
+│       ├── langchain_class.py
+│       ├── langchain_models.py
+│       └── langchain_tools.py
+└── tests/
+    └── test_bot.py
+```
+
+## Contributing
+
+Contributions are welcome. Please open an issue to discuss major changes you'd like to make.
+
+## License
+
+This project is licensed under the MIT License.

sonika_langchain_bot-0.0.12/README.md

@@ -0,0 +1,174 @@
+# Sonika LangChain Bot <a href="https://pepy.tech/projects/sonika-langchain-bot"><img src="https://static.pepy.tech/badge/sonika-langchain-bot" alt="PyPI Downloads"></a>
+
+A Python library that implements a conversational agent using LangChain with tool execution capabilities and text classification.
+
+## Installation
+
+```bash
+pip install sonika-langchain-bot
+```
+
+## Prerequisites
+
+You'll need the following API keys:
+
+- OpenAI API Key
+
+Create a `.env` file in the root of your project with the following variables:
+
+```env
+OPENAI_API_KEY=your_api_key_here
+```
+
+## Key Features
+
+- Conversational agent with tool execution capabilities
+- Text classification with structured output
+- Custom tool integration
+- Streaming responses
+- Conversation history management
+- Flexible instruction-based behavior
+
+## Basic Usage
+
+### Agent with Tools Example
+
+```python
+import os
+from dotenv import load_dotenv
+from langchain_openai import OpenAIEmbeddings
+from sonika_langchain_bot.langchain_tools import EmailTool
+from sonika_langchain_bot.langchain_bot_agent import LangChainBot
+from sonika_langchain_bot.langchain_class import Message, ResponseModel
+from sonika_langchain_bot.langchain_models import OpenAILanguageModel
+
+# Load environment variables
+load_dotenv()
+
+# Get API key from .env file
+api_key = os.getenv("OPENAI_API_KEY")
+
+# Initialize language model and embeddings
+language_model = OpenAILanguageModel(api_key, model_name='gpt-4o-mini-2024-07-18', temperature=1)
+embeddings = OpenAIEmbeddings(api_key=api_key)
+
+# Configure tools
+tools = [EmailTool()]
+
+# Create agent instance
+bot = LangChainBot(language_model, embeddings, instructions="You are an agent", tools=tools)
+
+# Load conversation history
+bot.load_conversation_history([Message(content="My name is Erley", is_bot=False)])
+
+# Get response
+user_message = 'Send an email with the tool to erley@gmail.com with subject Hello and message Hello Erley'
+response_model: ResponseModel = bot.get_response(user_message)
+
+print(response_model)
+```
+
+### Streaming Response Example
+
+```python
+import os
+from dotenv import load_dotenv
+from langchain_openai import OpenAIEmbeddings
+from sonika_langchain_bot.langchain_bot_agent import LangChainBot
+from sonika_langchain_bot.langchain_class import Message
+from sonika_langchain_bot.langchain_models import OpenAILanguageModel
+
+# Load environment variables
+load_dotenv()
+
+# Get API key from .env file
+api_key = os.getenv("OPENAI_API_KEY")
+
+# Initialize language model and embeddings
+language_model = OpenAILanguageModel(api_key, model_name='gpt-4o-mini-2024-07-18', temperature=1)
+embeddings = OpenAIEmbeddings(api_key=api_key)
+
+# Create agent instance
+bot = LangChainBot(language_model, embeddings, instructions="Only answers in english", tools=[])
+
+# Load conversation history
+bot.load_conversation_history([Message(content="My name is Erley", is_bot=False)])
+
+# Get streaming response
+user_message = 'Hello, what is my name?'
+for chunk in bot.get_response_stream(user_message):
+    print(chunk)
+```
+
+### Text Classification Example
+
+```python
+import os
+from dotenv import load_dotenv
+from sonika_langchain_bot.langchain_clasificator import TextClassifier
+from sonika_langchain_bot.langchain_models import OpenAILanguageModel
+from pydantic import BaseModel, Field
+
+# Load environment variables
+load_dotenv()
+
+# Define classification structure with Pydantic
+class Classification(BaseModel):
+    intention: str = Field()
+    sentiment: str = Field(..., enum=["happy", "neutral", "sad", "excited"])
+    aggressiveness: int = Field(
+        ...,
+        description="describes how aggressive the statement is, the higher the number the more aggressive",
+        enum=[1, 2, 3, 4, 5],
+    )
+    language: str = Field(
+        ..., enum=["spanish", "english", "french", "german", "italian"]
+    )
+
+# Initialize classifier
+api_key = os.getenv("OPENAI_API_KEY")
+model = OpenAILanguageModel(api_key=api_key)
+classifier = TextClassifier(llm=model, validation_class=Classification)
+
+# Classify text
+result = classifier.classify("how are you?")
+print(result)
+```
+
+## Available Classes and Components
+
+### Core Classes
+
+- **LangChainBot**: Main conversational agent for task execution with tools
+- **OpenAILanguageModel**: Wrapper for OpenAI language models
+- **TextClassifier**: Text classification using structured output
+- **Message**: Message structure for conversation history
+- **ResponseModel**: Response structure from agent interactions
+
+### Tools
+
+- **EmailTool**: Tool for sending emails through the agent
+
+## Project Structure
+
+```
+your_project/
+├── .env                    # Environment variables
+├── src/
+│   └── sonika_langchain_bot/
+│       ├── langchain_bot_agent.py
+│       ├── langchain_clasificator.py
+│       ├── langchain_class.py
+│       ├── langchain_models.py
+│       └── langchain_tools.py
+└── tests/
+    └── test_bot.py
+```
+
+## Contributing
+
+Contributions are welcome. Please open an issue to discuss major changes you'd like to make.
+
+## License
+
+This project is licensed under the MIT License.

{sonika_langchain_bot-0.0.10 → sonika_langchain_bot-0.0.12}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="sonika-langchain-bot",
-    version="0.0.10", 
+    version="0.0.12", 
     description="Agente langchain con LLM",
     author="Erley Blanco Carvajal",
     license="MIT License",
@@ -11,23 +11,23 @@ setup(
     packages=find_packages(where="src"),  # Encuentra los paquetes dentro de "src"
     package_dir={"": "src"},  # Indica que los paquetes están en el directorio "src"
     install_requires=[
-        "langchain>=0.3.0,<1.0.0",  # Permite mayor flexibilidad
-        "langchain-community>=0.3.0,<1.0.0",
-        "langchain-core>=0.3.5,<1.0.0",
-        "langchain-openai>=0.2.0,<1.0.0",
-        "langgraph>=0.2.39,<1.0.0",
-        "langgraph-checkpoint>=2.0.2,<3.0.0",
-        "langgraph-sdk>=0.1.34,<2.0.0",
-        "dataclasses-json>=0.6.7,<1.0.0",
-        "python-dateutil>=2.9.0,<3.0.0",
-        "tiktoken>=0.7.0,<1.0.0",
-        "pydantic>=2.9.2,<3.0.0",
-        "faiss-cpu>=1.8.0,<2.0.0",
-        "pypdf>=5.0.0,<6.0.0",
-        "python-dotenv>=1.0.1,<2.0.0",
-        "typing_extensions>=4.12.0,<5.0.0",
-        "typing-inspect>=0.9.0,<1.0.0",
+        "langchain-mcp-adapters==0.1.9",
+        "langchain-community==0.3.26",
+        "langchain-core==0.3.66",
+        "langchain-openai==0.3.24",
+        "langgraph==0.4.8",
+        "langgraph-checkpoint==2.1.0",
+        "langgraph-sdk==0.1.70",
+        "dataclasses-json==0.6.7",
+        "python-dateutil==2.9.0.post0",
+        "pydantic==2.11.7",
+        "faiss-cpu==1.11.0",
+        "pypdf==5.6.1",
+        "python-dotenv==1.0.1",
+        "typing_extensions==4.14.0",
+        "typing-inspect==0.9.0",
     ],
+
     extras_require={
         "dev": [
             "sphinx>=8.1.3,<9.0.0",