Python无法直接调用SikuliX，但可通过四种方式集成：1. Jython运行.sikuli脚本；2. subprocess调用sikulix.jar执行项目；3. REST API远程控制；4. OpenCV+PyAutoGUI等纯Python替代方案。
Python 本身不能直接调用 SikuliX，因为 SikuliX 是基于 Java 的图形自动化工具（依赖 OpenCV 和 Java AWT），但可以通过以下几种主流方式在 Python 环境中使用 SikuliX 的能力：
1. 使用 Jython 运行 SikuliX 脚本
SikuliX 官方推荐的方式是用
Jython
（Python 的 Java 实现）来运行 .sikuli 脚本或调用 SikuliX API。Jython 能直接加载 Java 类，因此可以无缝调用 SikuliX 的 Screen、Region、App 等类。
下载并安装
SikuliX
（含 Jython 环境）
将你的 Python 脚本保存为
文件，用 SikuliX 自带的 Jython 解释器执行：
示例代码：
2. 通过 subprocess 调用 SikuliX IDE 执行 .sikuli 项目
如果你已有 SikuliX IDE 录制好的
文件夹，可用 Python 的
subprocess
模块启动 SikuliX 命令行运行它：
确保已安装 SikuliX 并配置好
环境变量
命令格式（Windows 示例）：
Python 中调用：
3. 使用 REST API（SikuliX Server 模式）
SikuliX 支持以服务器模式运行（
参数），暴露 HTTP 接口。Python 可通过
requests
发送指令，实现远程控制：
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。
下载
立即学习
“
Python免费学习笔记（深入）
”；
启动服务：
Python 发起请求（需安装 requests）：
⚠️ 注意：该功能从 SikuliX 2.0.6+ 开始支持，需确保版本兼容且端口未被占用。
4. 替代方案：用纯 Python 库模拟类似功能
如果只是需要图像识别 + 鼠标操作，不强依赖 SikuliX，可考虑更轻量、纯 Python 的组合：
OpenCV + PyAutoGUI
：用 cv2.matchTemplate 找图，用 pyautogui.click 坐标
pywin32（Windows）或 Quartz（macOS）
：截图 + 模板匹配
优点：无 Java 依赖，跨平台更可控；缺点：需自行处理缩放、多屏、抗干扰等细节
.pysikulix.jar -r your_script.pyfrom sikuli import *
screen = Screen()
if screen.exists("login_button.png"):
screen.click("login_button.png")
xxx.sikuliSIKULIX_HOMEjava -jar sikulix.jar -r "C:\path\to\your.sikuli"import subprocess
subprocess.run([
'java', '-jar', 'sikulix.jar',
'-r', r'C:\myproject\login.sikuli'
])
-sjava -jar sikulix.jar -simport requests
# 检查屏幕是否存在图片
resp = requests.post('http://localhost:50001/exists', json={'pattern': 'ok.png'})
if resp.json().get('exists'):
requests.post('http://localhost:50001/click', json={'pattern': 'ok.png'})