下载

概述

• 概述
• 标准安装选项
  • Windows
  • Mac OS
  • Linux / Ubuntu
• 高级安装选项
  • PyPi（跨平台）
  • Anaconda（跨平台）
  • 旧版 OpenSesame 和其他 Python 版本
  • 源代码
• 提示
  • 应该使用哪个 Python 版本？
  • 什么时候需要（或不需要）更新？
  • 手动升级软件包
  • 系统管理员提示

标准安装选项

最新的 stable 版本为 4.1 Neonatal Nightingale (发行说明)。

Windows

标准 Windows 安装程序 (.exe)

标准 Windows 免安装包 (.zip)

大多数用户会下载 .exe 安装包。如果您没有管理员权限，或者需要同时运行多个版本的 OpenSesame，请下载 .zip 包。

基于 64 位系统的 Python 3.13。已在 Windows 11 上测试。

Mac OS

Mac OS 软件包 (.dmg)

首次启动 OpenSesame 时，操作系统会拦截该应用，因为它不是来自受信任的开发者。您可以在 设置 > 隐私与安全 中找到“仍然打开”选项。该选项会在应用被拦截后出现。

基于 64 位 intel 系统的 Python 3.13。已在 Mac OS X Sequoia 上测试。

Linux / Ubuntu

将以下命令复制粘贴到终端。这将下载并运行安装脚本。

# 这些软件包需要在 Ubuntu 24.04 上安装。
# 其他 Linux 发行版请安装等效软件包。
sudo apt install curl python3-venv libxcb-cursor0
# 下载并运行 OpenSesame 安装脚本。
bash <(curl -L https://github.com/open-cogsci/OpenSesame/raw/refs/heads/4.1/linux-installer.sh) --install

已在 Ubuntu 24.04（Python 3.12）上测试。

高级安装选项

PyPi（跨平台）

所有软件包均可通过 pip 安装。注意：在 PyPi 上 OpenSesame 称为 opensesame-core。

OpenSesame 核心依赖：

pip install --pre opensesame-core opensesame-extension-sigmund opensesame-extension-osweb opensesame-extension-updater opensesame-plugin-psychopy opensesame-plugin-media_player_mpy pygame

PsychoPy 作为（默认）psycho 后端。根据您的操作系统和 Python 版本，PsychoPy 可能无法正确安装。如遇此问题，请在支持论坛寻求帮助或使用预制包/安装程序。

pip install psychopy psychopy_sounddevice psychopy_visionscience 

用于眼动追踪的 PyGaze：

pip install https://github.com/smathot/PyGaze/releases/download/prerelease%2F0.8.0a3/python_pygaze-0.8.0a3-py3-none-any.whl

用于 xpyriment 后端的 Expyriment

pip install http://files.cogsci.nl/expyriment-0.10.0+opensesame2-py3-none-any.whl 

安装所有软件包后，只需运行：

opensesame

或者使用 Sigmund Analyst（代码编辑器）：

sigmund-analyst

Anaconda（跨平台）

首先，为 OpenSesame 创建一个新的 Python 环境（可选）

conda create -n opensesame-41 python=3.13
conda activate opensesame-41

接下来，请参照上方 PyPi 安装指南。当前不再提供专用的 Anaconda 软件包。

旧版 OpenSesame 和其他 Python 版本

旧版 OpenSesame 以及基于不同 Python 版本（3.10、3.11 和 3.12）构建的软件包可在 GitHub releases 获取：

• https://github.com/open-cogsci/OpenSesame/releases

源代码

OpenSesame 的源代码可在 GitHub 获取。

提示

应该使用哪个 Python 版本？

OpenSesame 目前使用 Python 3.13 进行构建和测试。其他版本 (>=3.10) 也能使用，但未经过全面测试。不再支持 Python 2。最后一个包含 Python 2 软件包的版本是 3.3.12，仍可从 release archive 下载。

什么时候需要（或不需要）更新？

• 在开发和测试实验时更新；建议始终使用 OpenSesame 的最新版本。
• 不要在运行实验时更新；也就是说，在收集数据期间不要进行更新。
• 运行实验时应使用与开发和测试相同版本的 OpenSesame。

手动升级软件包

OpenSesame 是常规 Python 环境，你可以在 Jupyter 控制台中运行 pip install 命令。

系统管理员提示

• 当 OpenSesame 发布新主版本（版本号以 0 结尾，如 3.1.0）时，通常很快会推出一到两个维护版本（如 3.1.1 和 3.1.2），以修复主要 bug。因此，如果你在不经常更新的系统上安装 OpenSesame，建议等到第二或第三个维护版本（如 3.0.2、3.1.3 等）再进行安装。这样可以最大限度地减少部署包含主要 bug 的 OpenSesame 版本的风险。
• Windows 安装程序允许你使用 /S 标志静默安装 OpenSesame。