
Colloq:可自托管的协作式 Python 教学平台发布
来源标题:Colloq – A collaborative Python classroom you can self-host
Colloq 是一个可自托管的协作式 Python 课堂工具,教师创建课程后分享一个链接,学生只需输入姓名即可加入同一个实时 Notebook。所有人共享相同文件与运行中的 Python 进程,任一学生运行单元格时全班都能看到结果,无需学生账号或环境配置。该工具采用 MIT 许可证,安装需 Python 3.9 以上,运行课程需 Docker。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
一个链接。一个实时 notebook。整个教室。 一个可自托管的课堂,用来一起教 Python、数据科学和 ML。 学生只需输入名字,就能从浏览器加入。 快速开始 · 课堂如何进行 · 文档 · 贡献 分享一个链接;课堂坐满人,每个人都能看到其他人在哪里。 pip install colloq colloq start # 在本机开一堂课,在浏览器里 colloq start --share # ……再生成一个链接发给学生 安装需要 Python 3.9 或更新版本;运行课堂需要 Docker (macOS 和 Linux;Windows 上用 WSL 2)。在 macOS 14+ 和 Linux x64/arm64 上, 安装包自带 Node.js;其他平台需要 Node.js 22 或更新版本。服务器、Web 应用和房间镜像 都随安装包提供,你的课堂数据存放在 ~/.colloq。 文档 · 你的第一堂课 · 发布版本 · 从源码构建 老师创建一堂课并分享链接。学生输入名字,获得一个标记,然后就进来了:和所有人一样的 notebook、一样的文件、一样的运行中的 Python 进程。没有学生账号,无需安装,也不用手动 配置环境。有人运行一个 cell,所有人都能看到结果。 Colloq 运行在你自己的机器或服务器上,采用 MIT 许可证。它为“一起发生的课堂”而建: 现场编码练习、随时开放提问的讲座,或者老师把个别同学的尝试带回全班的练习。 状态:pre-1.0;上面的版本徽章显示当前版本。Colloq 用于作者自己的课程。在 1.0 之前,版本发布仍可能改变某些行为,因此升级已有课堂数据的 实例前,请先阅读 CHANGELOG.md。 研讨模式:一起写,一次运行 所有人实时编辑同一批 cell,并看到谁在哪里输入。每个 notebook 有自己的 Python kernel:运行进入可见的队列,输出送达所有人,一个学生定义的变量对下一个 人可用。因此同一堂课里并排打开的讲座和研讨不共享变量,它们可以同时进行计算。 迟到的人看到的是 notebook 的当前状态。这是 Standard 预设。 把 cell 作为 council 打开,每个学生都在自己的纸上写;只有老师能看到文本。老师的 council 控制台是一个独立窗口,列出已提交的作业和运行队列,为每次运行设置时限,把每份答案标记为 正确或需要修改,并向全班展示一份答案(可带名字或不带名字)。这些尝试共享该 notebook 的 一个 kernel——或者,在 council 于多台机器上计算的课堂里,在一组 worker 上同时运行,每个 worker 基于 notebook 的一个快照——所以 council 是教学工具,不是隔离的评分沙箱 (详见下文)。 从 Lecture 控制台展示 PDF,专为 iPad 和手写笔打造:翻页、用八种颜色书写、在字迹下方 高亮、用指针书写(一个字只在你停笔后才淡出)、放大细节,并在任意幻灯片后添加一张网格纸或 横线纸。投影窗口(/s/:id/screen)和每个学生的屏幕都会跟随,包括缩放,墨迹在每块屏幕上 落在相同的位置。学生可以按“Read on my own”自行翻页,按“To lecture”回到演示者的页面。 创建课堂时选择一个预设,然后在课前或课中调整房间规则。权限由服务器强制执行。 预设设定初始规则;cell 的锁让单个练习改变房间的参与方式。在任何预设下,一个 cell 可以是: 无论卡片怎么设置,房间都可以改变:打开一个 cell 会做什么;谁编辑 cell 的文本;谁运行代码; cell 在多少秒后自行停止;是否运行危险命令;代码 cell 是否显示行号;谁改变结构;谁可以把 文档放到房间屏幕上;谁可以创建和编辑文件;学生是否可以启动自己的 notebook;Oracle 是否 可以对房间的文件进行操作;每个请求的动作数;每小时提问数;问题之间的秒数;谁可以读取 历史;谁可以重启 kernel;以及谁可以清除共享的工作。这些设置的来源是 rule-rows.ts。 一个房间包含多个 notebook,每个 notebook 也有自己的访问权限—— 与房间一样,可以是 personal(其作者和老师在其中工作)、 对所有人开放,或仅老师——从 notebook 标签页上的 Access 菜单设置。它只覆盖该 notebook 的编辑、运行和结构权限;文件、终端和共享屏幕仍由房间共享。 学生是否可以启动自己的 notebook 是一个单独的规则,默认关闭——由老师授予权限,而不是 学生——自己的 notebook 从创建那一刻起就是 personal 的。personal notebook 是唯一一种还会 在单独容器中运行的 notebook:绝不使用课堂的 GPU,有自己的内存 cgroup,因此一个贪婪的 草稿不会把 OOM killer 引到老师的 kernel 上——其作者可以重启它的 kernel 并清除输出,无需 征求同意。 Oracle 是否在此房间中回答,在创建表单上选择:按实例设置、关闭、仅提示或完整答案。它不 属于前面那些规则行,之后也无法在房间设置中更改。房间限制可以收紧实例设置,绝不能放宽。 执行和编辑权限需要与练习相匹配。如果学生可以编辑 cell,他们就能改变老师最终运行的源代码。 如果他们可以执行 Python,他们就能通过 Python 访问房间的文件,无论 Files 面板中有何限制。 所有者可以在 /admin 管理课堂、老师、环境和 Oracle 设置。老师通过个人链接登录;学生通过 课堂链接加入。老师链接和所有者的设置 token 授予工作人员访问权限,必须保密。添加老师不会 发送邮件。 Oracle 位于房间的共享线程中:整个房间都能看到每个问题和每个答案,因此一个学生的提问能 帮助下一个人。它会读取 notebook 的上下文,包括代码和输出。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。