bohr-agent-sdk 0.1.101__py3-none-any.whl → 0.1.103__py3-none-any.whl

bohr_agent_sdk-0.1.101.dist-info/METADATA

@@ -1,224 +0,0 @@
-Metadata-Version: 2.4
-Name: bohr-agent-sdk
-Version: 0.1.101
-Summary: SDK for scientific agents
-Home-page: https://github.com/dptech-corp/bohr-agent-sdk/
-Author: DP Technology
-Maintainer-email: liupeng <liupeng@dp.tech>, zjgemi <liuxzj@dp.tech>
-License: MIT
-Project-URL: Homepage, https://github.com/dptech-corp/bohr-agent-sdk
-Project-URL: repository, https://github.com/dptech-corp/bohr-agent-sdk
-Project-URL: Bug Reports, https://github.com/dptech-corp/bohr-agent-sdk/issues
-Keywords: agent SDK,AI for science
-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: Programming Language :: Python :: 3.13
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: click>=8.0.0
-Requires-Dist: mcp
-Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: typing-extensions>=4.8.0
-Requires-Dist: dpdispatcher>=0.6.8
-Requires-Dist: lbg>=1.2.29
-Requires-Dist: jsonpickle>=3.0.3
-Requires-Dist: psutil>=5.9.6
-Requires-Dist: paho-mqtt>=2.1.0
-Requires-Dist: redis>=6.2.0
-Requires-Dist: twine>=6.1.0
-Requires-Dist: build>=1.2.2.post1
-Provides-Extra: device
-Requires-Dist: pywinauto-recorder>=0.1.0; extra == "device"
-Provides-Extra: cloud
-Requires-Dist: paho-mqtt>=1.6.1; extra == "cloud"
-Requires-Dist: redis>=5.0.1; extra == "cloud"
-Requires-Dist: aiohttp>=3.9.1; extra == "cloud"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.4.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: black>=23.11.0; extra == "dev"
-Requires-Dist: isort>=5.12.0; extra == "dev"
-Requires-Dist: mypy>=1.7.0; extra == "dev"
-Requires-Dist: pylint>=3.0.0; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: sphinx>=7.2.0; extra == "docs"
-Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
-Provides-Extra: all
-Requires-Dist: bohr-agent-sdk[bohrium,cloud,dev,device,dispatcher,docs]; extra == "all"
-Dynamic: home-page
-Dynamic: requires-python
-
-# Bohrium Science Agent SDK
-
-这是DP Tech的Bohrium Science Agent SDK，提供了一个命令行工具dp-agent，用于管理科学计算任务。同时提供了Python SDK用于开发自定义的科学计算应用。
-
-## 安装
-
-```bash
-pip install bohr-agent-sdk -i https://pypi.org/simple --upgrade
-```
-
-## CLI 使用方法
-
-安装后，您可以使用以下命令：
-
-### 获取资源
-
-```bash
-# 获取基础代码结构
-dp-agent fetch scaffolding --type=calculation/device
-
-# 获取配置文件
-dp-agent fetch config
-```
-
-`fetch config` 命令会下载 .env 配置文件并替换部分动态变量，如 MQTT_DEVICE_ID。
-注意：出于安全考虑，此功能仅在内网环境可用。其他环境需要手动配置。
-
-### 运行命令
-
-```bash
-# 运行实验环境
-dp-agent run tool device
-
-# 运行云环境
-dp-agent run tool cloud
-
-# 运行计算环境
-dp-agent run tool calculation
-
-# 运行代理
-dp-agent run agent
-
-# 调试模式
-dp-agent run debug
-```
-
-## SDK 快速入门
-
-Bohrium Science Agent SDK 提供了两种主要的开发模式：实验室模式（Lab）和云模式（Cloud）。
-
-### 基础结构
-
-安装完成并运行 `dp-agent fetch scaffolding` 后，您将获得以下基础项目结构：
-
-```
-your-project/
-├── lab/                # 实验室模式相关代码
-│   ├── __init__.py
-│   └── tescan_device.py  # 设备控制示例
-├── cloud/              # 云模式相关代码
-│   └── __init__.py
-└── main.py            # 主程序入口
-```
-
-### 实验室模式开发
-
-实验室模式主要用于控制本地实验设备。以下是一个基于 Tescan 设备的示例：
-
-```python
-from typing import Dict, TypedDict
-from dp.agent.device.device import Device, action, BaseParams, SuccessResult
-
-class TakePictureParams(BaseParams):
-    """拍照参数"""
-    horizontal_width: str
-
-class PictureData(TypedDict):
-    """照片数据"""
-    image_id: str
-
-class PictureResult(SuccessResult):
-    """拍照结果"""
-    data: PictureData
-
-class MyDevice(Device):
-    device_name = "my_device"
-    
-    @action("take_picture")
-    def take_picture(self, params: TakePictureParams) -> PictureResult:
-        """拍照动作
-        
-        Args:
-            params: 拍照参数
-                - horizontal_width: 图片水平宽度
-        """
-        hw = params.get("horizontal_width", "default")
-        return PictureResult(
-            message=f"Picture taken with {self.device_name}",
-            data={"image_id": "image_123"}
-        )
-```
-
-### 云端开发
-
-云模式基于 MCP (Message Control Protocol) 实现，用于处理远程设备控制和任务调度。register_mcp_tools 通过 python 的自省和反射机制实现了设备控制的自动注册，无需重复实现操作定义。
-以下展示如何创建设备并注册到 MCP 服务器：
-
-```python
-"""
-Example of using the bohr-agent-sdk cloud functionality.
-"""
-import signal
-import sys
-from dp.agent.cloud import mcp, get_mqtt_cloud_instance
-from dp.agent.device.device import TescanDevice, register_mcp_tools
-
-def signal_handler(sig, frame):
-    """Handle SIGINT signal to gracefully shutdown."""
-    print("Shutting down...")
-    get_mqtt_cloud_instance().stop()
-    sys.exit(0)
-
-def main():
-    """Start the cloud services."""
-    print("Starting Tescan Device Twin Cloud Services...")
-    
-    # Register signal handler
-    signal.signal(signal.SIGINT, signal_handler)
-    
-    # Create device instance
-    device = TescanDevice(mcp, device)
-    
-    # Register device tools
-    register_mcp_tools(device)
-    
-    # Start MCP server
-    print("Starting MCP server...")
-    mcp.run(transport="sse")
-
-if __name__ == "__main__":
-    main()
-```
-
-
-### 配置说明
-
-在 `.env` 文件中配置必要的环境变量：
-
-```
-MQTT_INSTANCE_ID=your_instance_id
-MQTT_ENDPOINT=your_endpoint
-MQTT_DEVICE_ID=your_device_id
-MQTT_GROUP_ID=your_group_id
-MQTT_AK=your_access_key
-MQTT_SK=your_secret_key
-```
-
-### 主要功能
-
-- 设备控制接口（Lab模式）
-  - 设备初始化
-  - 命令执行
-  - 状态监控
-  
-- 云端任务处理（Cloud模式）
-  - 任务队列管理
-  - 计算资源调度
-  - 结果回传
-
-更详细的API文档请参考代码中的注释。

bohr_agent_sdk-0.1.101.dist-info/RECORD

@@ -1,40 +0,0 @@
-dp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dp/agent/__init__.py,sha256=4kwF1khocxEkqJjnVhBV5cCsWkR_MBGrUthuHk44pT8,153
-dp/agent/adapter/adk/__init__.py,sha256=mxX2SxGgDjwQ7WjfKMw9mQkq4ddl8XlCA6gnUinCW0w,493
-dp/agent/adapter/adk/storage_artifact_service.py,sha256=Hd1CmEB8HgEz3x_riHVSSmYdw6W2bDYYa3c5ySCqmCE,5414
-dp/agent/adapter/adk/utils.py,sha256=Hf6zZOmNi0YSI9t5acmR5kzowWaYr-UfyPiN8fefPkI,7359
-dp/agent/adapter/adk/client/__init__.py,sha256=F1xfFNa4ZG8jV9adeGI2D3YBiSX-5RkvqEdTqNdJce4,209
-dp/agent/adapter/adk/client/calculation_mcp_tool.py,sha256=8_uBP12SLaYUiQL6c0vysVsePEZS_r0YMogvW93ZFHo,12188
-dp/agent/adapter/camel/__init__.py,sha256=RN1NhdmsJyN43fTxTXFld4UKZksjpSV0b2QvFn5gK7o,77
-dp/agent/adapter/camel/client/__init__.py,sha256=ld-r0_WsZLFv6yyrmxjWmR8JgnrQzOw4fX0hwVHzciY,93
-dp/agent/adapter/camel/client/calculation_mcp_client.py,sha256=JZZUYYfMgXvHzK4f6IJp-ia33wn3aYZqDSDVa5yKtdc,1860
-dp/agent/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dp/agent/cli/cli.py,sha256=dm2_qH_1Dzlc3IH-BBwEPDJcJrew58AV0dNzwEMn6cY,8219
-dp/agent/cloud/__init__.py,sha256=e16ymCZX2f-S8DyGB5jSK8gnQqVObRIsvtLXLALIKxQ,441
-dp/agent/cloud/main.py,sha256=5QIEjpZ1RxWnR8wyLf-vlgz1bn9oOnxCYn158LBaLN4,727
-dp/agent/cloud/mcp.py,sha256=tsAwC3doVMLYr6Oh8PxVqF-qCygYkDZJTIhoF_h8eGQ,4537
-dp/agent/cloud/mqtt.py,sha256=e8Dz1Wffzjj8V0Xrr6LukwfdiPrj9VsVXatD3u4NpkQ,23036
-dp/agent/device/__init__.py,sha256=G3i0zG7orCgMcXBEEhm7dufDeKY0QgFdQinOjDh8zSg,400
-dp/agent/device/mqtt_device_twin.py,sha256=xHQFi2WQxrL5KqSEU2DeRSBiaPT5FLXvgszinyanQ_Q,8671
-dp/agent/device/device/__init__.py,sha256=w7_1S16S1vWUq0RGl0GFgjq2vFkc5oNvy8cQTnvPm24,319
-dp/agent/device/device/device.py,sha256=9ZRIJth-4qMO-i-u_b_cO3d6a4eTbTQjPaxFsV_zEkc,9643
-dp/agent/device/device/types.py,sha256=JuxB-hjf1CjjvfBxCLwRAXVFlYS-nPEdiJpBWLFVCzo,1924
-dp/agent/server/__init__.py,sha256=rckaYd8pbYyB4ENEhgjXKeGMXjdnrgcJpdM1gu5u1Wc,508
-dp/agent/server/calculation_mcp_server.py,sha256=eClRP7A-t5hMGyTh81KC3GAKjSPNJIylOrOKyzqwo8o,11459
-dp/agent/server/preprocessor.py,sha256=XUWu7QOwo_sIDMYS2b1OTrM33EXEVH_73vk-ju1Ok8A,1264
-dp/agent/server/utils.py,sha256=8jgYZEW4XBp86AF2Km6QkwHltBmrnS-soTpHov7ZEJw,4501
-dp/agent/server/executor/__init__.py,sha256=s95M5qKQk39Yi9qaVJZhk_nfj54quSf7EDghR3OCFUA,248
-dp/agent/server/executor/base_executor.py,sha256=EFJBsYVYAvuRbiLAbLOwLTw3h7ScjN025xnSP4uJHrQ,2052
-dp/agent/server/executor/dispatcher_executor.py,sha256=urpzmKH_tBOgblBdJEa3y8eEhXqUDrdcdWCnUdJpfZk,9420
-dp/agent/server/executor/local_executor.py,sha256=wYCclNZFkLb3v7KpW1nCnupO8piBES-esYlDAuz86zk,6120
-dp/agent/server/storage/__init__.py,sha256=Sgsyp5hb0_hhIGugAPfQFzBHt_854rS_MuMuE3sn8Gs,389
-dp/agent/server/storage/base_storage.py,sha256=728-oNG6N8isV95gZVnyi4vTznJPJhSjxw9Gl5Y_y5o,2356
-dp/agent/server/storage/bohrium_storage.py,sha256=EsKX4dWWvZTn2TEhZv4zsvihfDK0mmPFecrln-Ytk40,10488
-dp/agent/server/storage/http_storage.py,sha256=KiySq7g9-iJr12XQCKKyJLn8wJoDnSRpQAR5_qPJ1ZU,1471
-dp/agent/server/storage/local_storage.py,sha256=t1wfjByjXew9ws3PuUxWxmZQ0-Wt1a6t4wmj3fW62GI,1352
-dp/agent/server/storage/oss_storage.py,sha256=pgjmi7Gir3Y5wkMDCvU4fvSls15fXT7Ax-h9MYHFPK0,3359
-bohr_agent_sdk-0.1.101.dist-info/METADATA,sha256=aPSBkjXZHVZyRBAqdWQl_BNJnVxAcRbuK-izY7ibVXw,6330
-bohr_agent_sdk-0.1.101.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-bohr_agent_sdk-0.1.101.dist-info/entry_points.txt,sha256=5n5kneF5IbDQtoQ2WfF-QuBjDtsimJte9Rv9baSGgc0,86
-bohr_agent_sdk-0.1.101.dist-info/top_level.txt,sha256=87xLUDhu_1nQHoGLwlhJ6XlO7OsjILh6i1nX6ljFzDo,3
-bohr_agent_sdk-0.1.101.dist-info/RECORD,,