langchain-dev-utils 1.2.13__tar.gz → 1.2.15__tar.gz

langchain_dev_utils-1.2.15/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: langchain-dev-utils
+Version: 1.2.15
+Summary: A practical utility library for LangChain and LangGraph development
+Project-URL: Source Code, https://github.com/TBice123123/langchain-dev-utils
+Project-URL: repository, https://github.com/TBice123123/langchain-dev-utils
+Project-URL: documentation, https://tbice123123.github.io/langchain-dev-utils
+Author-email: tiebingice <tiebingice123@outlook.com>
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: langchain>=1.1.0
+Requires-Dist: langgraph>=1.0.0
+Provides-Extra: standard
+Requires-Dist: json-repair>=0.53.1; extra == 'standard'
+Requires-Dist: langchain-openai; extra == 'standard'
+Description-Content-Type: text/markdown
+
+# 🦜️🧰 langchain-dev-utils
+
+<p align="center">
+    <em>🚀 High-efficiency toolkit designed for LangChain and LangGraph developers</em>
+</p>
+
+<p align="center">
+  📚 <a href="https://tbice123123.github.io/langchain-dev-utils/">English</a> • 
+  <a href="https://tbice123123.github.io/langchain-dev-utils/zh/">中文</a>
+</p>
+
+[![PyPI](https://img.shields.io/pypi/v/langchain-dev-utils.svg?color=%2334D058&label=pypi%20package)](https://pypi.org/project/langchain-dev-utils/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/python-3.11|3.12|3.13|3.14-%2334D058)](https://www.python.org/downloads)
+[![Downloads](https://static.pepy.tech/badge/langchain-dev-utils/month)](https://pepy.tech/project/langchain-dev-utils)
+[![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://tbice123123.github.io/langchain-dev-utils)
+
+> This is the English version. For the Chinese version, please visit [中文版本](https://github.com/TBice123123/langchain-dev-utils/blob/master/README_cn.md)
+
+## ✨ Why choose langchain-dev-utils?
+
+Tired of writing repetitive code in LangChain development? `langchain-dev-utils` is the solution you need! This lightweight yet powerful toolkit is designed to enhance the development experience of LangChain and LangGraph, helping you:
+
+- ⚡ **Boost development efficiency** - Reduce boilerplate code, allowing you to focus on core functionality
+- 🧩 **Simplify complex workflows** - Easily manage multi-model, multi-tool, and multi-agent applications
+- 🔧 **Enhance code quality** - Improve consistency and readability, reducing maintenance costs
+- 🎯 **Accelerate prototype development** - Quickly implement ideas, iterate and validate faster
+
+
+## 🎯 Core Features
+
+- **🔌 Unified model management** - Specify model providers through strings, easily switch and combine different models
+- **💬 Flexible message handling** - Support for chain-of-thought concatenation, streaming processing, and message formatting
+- **🛠️ Powerful tool calling** - Built-in tool call detection, parameter parsing, and human review functionality
+- **🤖 Efficient Agent development** - Simplify agent creation process, expand more common middleware
+- **📊 Flexible state graph composition** - Support for serial and parallel composition of multiple StateGraphs
+
+## ⚡ Quick Start
+
+**1. Install `langchain-dev-utils`**
+
+```bash
+pip install -U "langchain-dev-utils[standard]"
+```
+
+**2. Start using**
+
+```python
+from langchain.tools import tool
+from langchain_core.messages import HumanMessage
+from langchain_dev_utils.chat_models import register_model_provider, load_chat_model
+from langchain_dev_utils.agents import create_agent
+
+# Register model provider
+register_model_provider("vllm", "openai-compatible", base_url="http://localhost:8000/v1")
+
+@tool
+def get_current_weather(location: str) -> str:
+    """Get the current weather for the specified location"""
+    return f"25 degrees, {location}"
+
+# Dynamically load model using string
+model = load_chat_model("vllm:qwen3-4b")
+response = model.invoke("Hello")
+print(response)
+
+# Create agent
+agent = create_agent("vllm:qwen3-4b", tools=[get_current_weather])
+response = agent.invoke({"messages": [HumanMessage(content="What's the weather like in New York today?")]})
+print(response)
+```
+
+**For more features of this library, please visit the [full documentation](https://tbice123123.github.io/langchain-dev-utils/)**
+
+
+## 🛠️ GitHub Repository
+
+Visit the [GitHub repository](https://github.com/TBice123123/langchain-dev-utils) to view the source code and report issues.
+
+---
+
+<div align="center">
+  <p>Developed with ❤️ and ☕</p>
+  <p>If this project helps you, please give us a ⭐️</p>
+</div>

langchain_dev_utils-1.2.15/README.md

@@ -0,0 +1,85 @@
+# 🦜️🧰 langchain-dev-utils
+
+<p align="center">
+    <em>🚀 High-efficiency toolkit designed for LangChain and LangGraph developers</em>
+</p>
+
+<p align="center">
+  📚 <a href="https://tbice123123.github.io/langchain-dev-utils/">English</a> • 
+  <a href="https://tbice123123.github.io/langchain-dev-utils/zh/">中文</a>
+</p>
+
+[![PyPI](https://img.shields.io/pypi/v/langchain-dev-utils.svg?color=%2334D058&label=pypi%20package)](https://pypi.org/project/langchain-dev-utils/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/python-3.11|3.12|3.13|3.14-%2334D058)](https://www.python.org/downloads)
+[![Downloads](https://static.pepy.tech/badge/langchain-dev-utils/month)](https://pepy.tech/project/langchain-dev-utils)
+[![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://tbice123123.github.io/langchain-dev-utils)
+
+> This is the English version. For the Chinese version, please visit [中文版本](https://github.com/TBice123123/langchain-dev-utils/blob/master/README_cn.md)
+
+## ✨ Why choose langchain-dev-utils?
+
+Tired of writing repetitive code in LangChain development? `langchain-dev-utils` is the solution you need! This lightweight yet powerful toolkit is designed to enhance the development experience of LangChain and LangGraph, helping you:
+
+- ⚡ **Boost development efficiency** - Reduce boilerplate code, allowing you to focus on core functionality
+- 🧩 **Simplify complex workflows** - Easily manage multi-model, multi-tool, and multi-agent applications
+- 🔧 **Enhance code quality** - Improve consistency and readability, reducing maintenance costs
+- 🎯 **Accelerate prototype development** - Quickly implement ideas, iterate and validate faster
+
+
+## 🎯 Core Features
+
+- **🔌 Unified model management** - Specify model providers through strings, easily switch and combine different models
+- **💬 Flexible message handling** - Support for chain-of-thought concatenation, streaming processing, and message formatting
+- **🛠️ Powerful tool calling** - Built-in tool call detection, parameter parsing, and human review functionality
+- **🤖 Efficient Agent development** - Simplify agent creation process, expand more common middleware
+- **📊 Flexible state graph composition** - Support for serial and parallel composition of multiple StateGraphs
+
+## ⚡ Quick Start
+
+**1. Install `langchain-dev-utils`**
+
+```bash
+pip install -U "langchain-dev-utils[standard]"
+```
+
+**2. Start using**
+
+```python
+from langchain.tools import tool
+from langchain_core.messages import HumanMessage
+from langchain_dev_utils.chat_models import register_model_provider, load_chat_model
+from langchain_dev_utils.agents import create_agent
+
+# Register model provider
+register_model_provider("vllm", "openai-compatible", base_url="http://localhost:8000/v1")
+
+@tool
+def get_current_weather(location: str) -> str:
+    """Get the current weather for the specified location"""
+    return f"25 degrees, {location}"
+
+# Dynamically load model using string
+model = load_chat_model("vllm:qwen3-4b")
+response = model.invoke("Hello")
+print(response)
+
+# Create agent
+agent = create_agent("vllm:qwen3-4b", tools=[get_current_weather])
+response = agent.invoke({"messages": [HumanMessage(content="What's the weather like in New York today?")]})
+print(response)
+```
+
+**For more features of this library, please visit the [full documentation](https://tbice123123.github.io/langchain-dev-utils/)**
+
+
+## 🛠️ GitHub Repository
+
+Visit the [GitHub repository](https://github.com/TBice123123/langchain-dev-utils) to view the source code and report issues.
+
+---
+
+<div align="center">
+  <p>Developed with ❤️ and ☕</p>
+  <p>If this project helps you, please give us a ⭐️</p>
+</div>

langchain_dev_utils-1.2.15/README_cn.md

@@ -0,0 +1,86 @@
+# 🦜️🧰 langchain-dev-utils
+
+<p align="center">
+    <em>🚀 专为 LangChain 和 LangGraph 开发者打造的高效工具库</em>
+</p>
+
+<p align="center">
+  📚 <a href="https://tbice123123.github.io/langchain-dev-utils/">English</a> • 
+  <a href="https://tbice123123.github.io/langchain-dev-utils/zh/">中文</a>
+</p>
+
+[![PyPI](https://img.shields.io/pypi/v/langchain-dev-utils.svg?color=%2334D058&label=pypi%20package)](https://pypi.org/project/langchain-dev-utils/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/python-3.11|3.12|3.13|3.14-%2334D058)](https://www.python.org/downloads)
+[![Downloads](https://static.pepy.tech/badge/langchain-dev-utils/month)](https://pepy.tech/project/langchain-dev-utils)
+[![Documentation](https://img.shields.io/badge/docs-latest-blue)](https://tbice123123.github.io/langchain-dev-utils/zh/)
+
+> 当前为中文版，英文版请访问[English Version](https://github.com/TBice123123/langchain-dev-utils/blob/master/README.md)
+
+## ✨ 为什么选择 langchain-dev-utils？
+
+厌倦了在 LangChain 开发中编写重复代码？`langchain-dev-utils` 正是您需要的解决方案！这个轻量但功能强大的工具库专为提升 LangChain 和 LangGraph 开发体验而设计，帮助您：
+
+- ⚡ **提升开发效率** - 减少样板代码，让您专注于核心功能
+- 🧩 **简化复杂流程** - 轻松管理多模型、多工具和多智能体应用
+- 🔧 **增强代码质量** - 提高一致性和可读性，减少维护成本
+- 🎯 **加速原型开发** - 快速实现想法，更快迭代验证
+
+
+## 🎯 核心功能
+
+- **🔌 统一的模型管理** - 通过字符串指定模型提供商，轻松切换和组合不同模型
+- **💬 灵活的消息处理** - 支持思维链拼接、流式处理和消息格式化
+- **🛠️ 强大的工具调用** - 内置工具调用检测、参数解析和人工审核功能
+- **🤖 高效的 Agent 开发** - 简化智能体创建流程，扩充更多的常用中间件
+- **📊 灵活的状态图组合** - 支持串行和并行方式组合多个 StateGraph
+
+## ⚡ 快速开始
+
+**1. 安装 `langchain-dev-utils`**
+
+```bash
+pip install -U "langchain-dev-utils[standard]"
+```
+
+**2. 开始使用**
+
+```python
+from langchain.tools import tool
+from langchain_core.messages import HumanMessage
+from langchain_dev_utils.chat_models import register_model_provider, load_chat_model
+from langchain_dev_utils.agents import create_agent
+
+# 注册模型提供商
+register_model_provider("vllm", "openai-compatible", base_url="http://localhost:8000/v1")
+
+@tool
+def get_current_weather(location: str) -> str:
+    """获取指定地点的当前天气"""
+    return f"25度，{location}"
+
+# 使用字符串动态加载模型
+model = load_chat_model("vllm:qwen3-4b")
+response = model.invoke("你好")
+print(response)
+
+# 创建智能体
+agent = create_agent("vllm:qwen3-4b", tools=[get_current_weather])
+response = agent.invoke({"messages": [HumanMessage(content="今天纽约的天气如何？")]})
+print(response)
+```
+
+**获取更多的本库功能，请访问[完整文档](https://tbice123123.github.io/langchain-dev-utils/zh/)**
+
+
+## 🛠️ GitHub 仓库
+
+访问 [GitHub 仓库](https://github.com/TBice123123/langchain-dev-utils) 查看源代码和问题。
+
+
+---
+
+<div align="center">
+  <p>由 ❤️ 和 ☕ 驱动开发</p>
+  <p>如果这个项目对您有帮助，请给我们一个 ⭐️</p>
+</div>

{langchain_dev_utils-1.2.13 → langchain_dev_utils-1.2.15}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "langchain-dev-utils"
-version = "1.2.13"
+version = "1.2.15"
 description = "A practical utility library for LangChain and LangGraph development"
 readme = "README.md"
 authors = [{ name = "tiebingice", email = "tiebingice123@outlook.com" }]

langchain_dev_utils-1.2.15/src/langchain_dev_utils/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.2.15"

{langchain_dev_utils-1.2.13 → langchain_dev_utils-1.2.15}/src/langchain_dev_utils/agents/middleware/model_router.py

@@ -19,6 +19,7 @@ class ModelDict(TypedDict):
     model_description: str
     tools: NotRequired[list[BaseTool | dict[str, Any]]]
     model_kwargs: NotRequired[dict[str, Any]]
+    model_instance: NotRequired[BaseChatModel]
     model_system_prompt: NotRequired[str]
 
 
@@ -76,7 +77,7 @@ class ModelRouterMiddleware(AgentMiddleware):
             model name or a BaseChatModel instance
         model_list: List of available routing models, each containing model_name,
             model_description, tools(Optional), model_kwargs(Optional),
-            model_system_prompt(Optional)
+            model_instance(Optional), model_system_prompt(Optional)
         router_prompt: Routing prompt template, uses default template if None
 
     Examples:
@@ -155,6 +156,7 @@ class ModelRouterMiddleware(AgentMiddleware):
                 "tools": item.get("tools", None),
                 "kwargs": item.get("model_kwargs", None),
                 "system_prompt": item.get("model_system_prompt", None),
+                "model_instance": item.get("model_instance", None),
             }
             for item in self.model_list
         }
@@ -163,10 +165,13 @@ class ModelRouterMiddleware(AgentMiddleware):
         override_kwargs = {}
         if select_model_name != "default-model" and select_model_name in model_dict:
             model_values = model_dict.get(select_model_name, {})
-            if model_values["kwargs"] is not None:
-                model = load_chat_model(select_model_name, **model_values["kwargs"])
+            if model_values["model_instance"] is not None:
+                model = model_values["model_instance"]
             else:
-                model = load_chat_model(select_model_name)
+                if model_values["kwargs"] is not None:
+                    model = load_chat_model(select_model_name, **model_values["kwargs"])
+                else:
+                    model = load_chat_model(select_model_name)
             override_kwargs["model"] = model
             if model_values["tools"] is not None:
                 override_kwargs["tools"] = model_values["tools"]