update docs

Author: puke3615

README.md

@@ -35,10 +35,14 @@
 ```python
 from comfykit import ComfyKit
 
-kit = ComfyKit()
+# Connect to local ComfyUI server
+kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")
 result = await kit.execute("workflow.json", {"prompt": "a cute cat"})
 
 print(result.images)  # ['http://127.0.0.1:8188/view?filename=cat_001.png']
+
+# 🌐 Or use RunningHub cloud (no local GPU needed)
+# kit = ComfyKit(runninghub_api_key="rh-xxx")
 ```
 
 ### Get structured data back
@@ -129,8 +133,8 @@ import asyncio
 from comfykit import ComfyKit
 
 async def main():
-    # Initialize (uses default config)
-    kit = ComfyKit()
+    # Connect to local ComfyUI (default: http://127.0.0.1:8188)
+    kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")
 
     # Execute workflow
     result = await kit.execute(
@@ -148,6 +152,8 @@ async def main():
 asyncio.run(main())
 ```
 
+> 💡 **Tip**: `comfyui_url` defaults to `http://127.0.0.1:8188` and can be omitted
+
 ---
 
 ## 📚 Usage Examples
@@ -157,8 +163,8 @@ asyncio.run(main())
 ```python
 from comfykit import ComfyKit
 
-# Connect to local ComfyUI (default)
-kit = ComfyKit()
+# Connect to local ComfyUI
+kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")  # Default, can be omitted
 
 # Execute local workflow file
 result = await kit.execute("workflow.json", {

README_CN.md

@@ -36,10 +36,14 @@
 ```python
 from comfykit import ComfyKit
 
-kit = ComfyKit()
+# Connect to local ComfyUI server
+kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")
 result = await kit.execute("workflow.json", {"prompt": "a cute cat"})
 
 print(result.images)  # ['http://127.0.0.1:8188/view?filename=cat_001.png']
+
+# 🌐 Or use RunningHub cloud (no local GPU needed)
+# kit = ComfyKit(runninghub_api_key="rh-xxx")
 ```
 
 ### 获得结构化的返回数据
@@ -134,8 +138,8 @@ import asyncio
 from comfykit import ComfyKit
 
 async def main():
-    # 初始化（使用默认配置）
-    kit = ComfyKit()
+    # Connect to local ComfyUI (default: http://127.0.0.1:8188)
+    kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")
 
     # 执行 workflow
     result = await kit.execute(
@@ -153,6 +157,8 @@ async def main():
 asyncio.run(main())
 ```
 
+> 💡 **提示**：`comfyui_url` 默认为 `http://127.0.0.1:8188`，可省略此参数
+
 ### 方式 2：RunningHub 云端（无需本地环境）⭐
 
 如果你没有本地 GPU 或 ComfyUI 环境，可以使用 RunningHub 云平台：
@@ -188,8 +194,8 @@ asyncio.run(main())
 ```python
 from comfykit import ComfyKit
 
-# 默认连接本地 ComfyUI
-kit = ComfyKit()
+# Connect to local ComfyUI
+kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")  # Default, can be omitted
 
 # 执行本地 workflow 文件
 result = await kit.execute("workflow.json", {

docs/en/index.md

@@ -47,10 +47,14 @@
 ```python
 from comfykit import ComfyKit
 
-kit = ComfyKit()
+# Connect to local ComfyUI server
+kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")
 result = await kit.execute("workflow.json", {"prompt": "a cute cat"})
 
 print(result.images)  # ['http://127.0.0.1:8188/view?filename=cat_001.png']
+
+# 🌐 Or use RunningHub cloud (no local GPU needed)
+# kit = ComfyKit(runninghub_api_key="rh-xxx")
 ```
 
 ### Get structured data back

docs/en/quick-start.md

@@ -47,8 +47,8 @@ import asyncio
 from comfykit import ComfyKit
 
 async def main():
-    # Initialize (uses default config)
-    kit = ComfyKit()
+    # Connect to local ComfyUI (default: http://127.0.0.1:8188)
+    kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")
 
     # Execute workflow
     result = await kit.execute(
@@ -66,6 +66,8 @@ async def main():
 asyncio.run(main())
 ```
 
+> 💡 **Tip**: `comfyui_url` defaults to `http://127.0.0.1:8188` and can be omitted
+
 ## Understanding the Results
 
 When you execute a workflow, ComfyKit returns an `ExecuteResult` object:

docs/en/usage/basic.md

@@ -7,6 +7,7 @@ The most basic usage is to execute a local workflow file:
 ```python
 from comfykit import ComfyKit
 
+# Connect to local ComfyUI (default: http://127.0.0.1:8188)
 kit = ComfyKit()
 
 # Execute local workflow file

docs/zh/index.md

@@ -47,10 +47,14 @@
 ```python
 from comfykit import ComfyKit
 
-kit = ComfyKit()
+# Connect to local ComfyUI server
+kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")
 result = await kit.execute("workflow.json", {"prompt": "a cute cat"})
 
 print(result.images)  # ['http://127.0.0.1:8188/view?filename=cat_001.png']
+
+# 🌐 Or use RunningHub cloud (no local GPU needed)
+# kit = ComfyKit(runninghub_api_key="rh-xxx")
 ```
 
 ### 获得结构化的返回数据

docs/zh/quick-start.md

@@ -47,8 +47,8 @@ import asyncio
 from comfykit import ComfyKit
 
 async def main():
-    # 初始化（使用默认配置）
-    kit = ComfyKit()
+    # Connect to local ComfyUI (default: http://127.0.0.1:8188)
+    kit = ComfyKit(comfyui_url="http://127.0.0.1:8188")
 
     # 执行 workflow
     result = await kit.execute(
@@ -66,6 +66,8 @@ async def main():
 asyncio.run(main())
 ```
 
+> 💡 **提示**：`comfyui_url` 默认为 `http://127.0.0.1:8188`，可省略此参数
+
 ## 理解返回结果
 
 当你执行一个 workflow 时，ComfyKit 会返回一个 `ExecuteResult` 对象：

docs/zh/usage/basic.md

@@ -7,6 +7,7 @@
 ```python
 from comfykit import ComfyKit
 
+# Connect to local ComfyUI (default: http://127.0.0.1:8188)
 kit = ComfyKit()
 
 # 执行本地 workflow 文件