Пульт на планшете
Перо, маркер, ластик и указка. Добавьте чистый лист для вывода формулы; заметки спикера останутся только у вас.
Мария, студентка · ячейка 3
df = pd.read_csv("data.csv")
df.shape
Установка · три команды
Поставьте пакет.
Отправьте ссылку.
Colloq ставится как обычный Python-пакет и поднимает занятие на вашей машине. Студентам нужна одна ссылка — ни аккаунтов, ни установки Python.
pip install colloq
colloq start
занятие на этой машине
colloq start --share
одна ссылка для студентов, пока открыт терминал
01 / Семинар
Код на проекторе.
Курсоры всей группы.
Открываете ноутбук, и группа работает в нём вместе с вами. Правки и результаты запуска видны всем. Данные, которые вы загрузили в Python, доступны в следующих ячейках — в том числе студентам.
02 / Лекция
Пишите на слайде.
Видно даже с последнего ряда.
Загрузите PDF, откройте проекцию на большом экране и подключите планшет как пульт. Студенты видят слайды и ваши рукописные заметки в своих браузерах.
Проектор
Слайд на весь экран в отдельном окне. Можно листать стрелками или презентационным пультом и показывать код из ноутбука во время объяснения.
Студент
Может вернуться к предыдущей странице, дочитать и одним нажатием догнать лекцию. Ноутбук с практикой уже открыт в той же комнате.
Пульт рассчитан на iPad с Apple Pencil. Поддерживает отсечение ладони и Split View.
03 / Консилиум Новое
Одно задание.
У каждого —
своё решение.
Откройте ячейку в режиме «Консилиум». Студенты пишут каждый в своей версии: чужие ответы им не видны, пока вы не выберете один для общего разбора.
- 01Видно, кто ещё пишет и кто уже сдал.
- 02Каждый запуск ограничен по времени и идёт через общее ядро.
- 03Выбранное решение показывается классу — с именем автора или без.
Оракул может подготовить сводку и черновики ответов. Вы решаете, что отправить студентам.
Ответы отдельные, Python-ядро общее. Студенты используют подготовленные вами данные. Запуски идут по очереди; изменения общих объектов и файлов могут влиять на следующие решения.
Как начать занятие
Шаг 01 · Преподаватель
Подготовьте комнату
Выберите режим, окружение и правила доступа. Загрузите PDF, начните с пустого ноутбука или импортируйте материалы с GitHub.
Шаг 02 · Студент
Студенты входят по ссылке
Студент вводит имя и выбирает метку. Почта, пароль и установка Python на его компьютере не нужны.
Шаг 03 · Занятие
Проводите занятие
Показывайте слайды, пишите код вместе или предложите каждому своё решение. После занятия материалы можно перечитать по той же ссылке.
Попробуйте экран входа: введите имя и выберите метку. Это пример на странице — подключение к занятию здесь не происходит.
Всё, что нужно по ходу пары
Ноутбук, файлы, терминал и ИИ-помощник доступны в одной комнате. Кто может ими пользоваться, определяет преподаватель.
Одно ядро
Две ячейки одного документа. Порядок запуска выбираете вы.
Вы · ячейка 4
df["target"].mean()
Интерактивный пример: сначала запустите ячейку Марии, затем свою. Python здесь не выполняется.
Один документ на всех
Можно редактировать одну ячейку одновременно. Курсоры подписаны именами, правки появляются у всей группы.
Одно ядро на комнату
Переменная из третьей ячейки доступна в четвёртой независимо от того, кто её запускает. Вывод и очередь запусков общие.
Общий терминал
Установили пакет один раз — он доступен группе. Команды выполняются в окружении занятия.
Оракул в комнате
ИИ-помощник отвечает с учётом кода и вывода ячеек. Вопросы и ответы видит вся группа. При создании занятия можно выбрать подсказки или отключить помощника.
Общие файлы
Загрузите данные перетаскиванием, разложите файлы по папкам. Они доступны из ноутбука и терминала занятия.
Своё железо
Запускайте Colloq на своём компьютере или сервере. Для разных курсов можно подготовить отдельные окружения с нужными пакетами.
История комнаты
Посмотрите, кто изменил код. Преподаватель может восстановить ячейку или весь ноутбук; Ctrl+Z отменяет собственные правки.
Оракул правит ячейку
Попросите объяснить ошибку или предложить правку. Изменения кода видны до принятия; их можно отклонить.
Правила комнаты
Настраивайте, кто редактирует, запускает код и загружает файлы. После завершения занятия студентам остаётся доступ для чтения.
До первой пары
Практические
вопросы
Что общее, что сохраняется и где проходят границы инструмента.
Что остаётся после занятия?
Ноутбук, файлы и ответы оракула доступны по прежней ссылке. Кнопка «Закончить занятие» оставляет студентам чтение, а редактирование и запуски — преподавателю. Занятие можно продолжить; ноутбук можно скачать в формате .ipynb.
Что, если кто-то удалит код или запустит бесконечный цикл?
Преподаватель может остановить выполнение, восстановить ячейку из истории или ограничить редактирование и запуск. Перезапуск ядра сбросит переменные, но сохранит текст ноутбука и файлы.
А если студент потеряет соединение?
Занятие у остальных продолжается. Сохранённые в браузере правки синхронизируются после восстановления связи. По той же ссылке студент может вернуться в комнату.
Кто видит решения в «Консилиуме»?
Студент видит свой ответ, преподаватель — ответы группы. Для обсуждения преподаватель может показать выбранное решение всем. Вычисления проходят в общем ядре: этот режим предназначен для учебного разбора, а не для изолированной проверки экзаменационных работ.
Куда отправляются данные при работе с ИИ?
К настроенному вами провайдеру: вопрос, контекст ноутбука и диалога, а также открытого файла. При разборе «Консилиума» — задание и сданные решения; в режиме работы с файлами помощник может читать дополнительные файлы комнаты. Вы выбираете провайдера и задаёте лимиты.
Можно подключить локальную модель через Ollama или vLLM. Без настроенного провайдера занятие работает без оракула.
Подойдёт для дистанционного занятия?
Да, если сервер доступен группе по сети. Голос и видео остаются в привычном сервисе звонков, а код, слайды и задания открываются в Colloq.
Можно вести здесь весь курс?
Colloq отвечает за само занятие и его материалы. Расписание, домашние задания, оценки и ведомости остаются в вашей системе управления курсом.
На своей машине
Окружение курса
под вашим контролем.
Colloq можно развернуть на ноутбуке преподавателя, кафедральном сервере или VPS. Python работает на этой машине; студенты подключаются из браузера.
Исходный код открыт под MIT, пакет лежит на PyPI. Python выполняется на вашей машине, материалы занятия остаются там же.
Что потребуется
-
01
Компьютер или сервер
Python, Node.js 22+ и Docker; ресурсы — под задачи курса.
-
02
Адрес, доступный группе
Локальная сеть, свой домен или
--share. Адреса Cloudflare не открываются из России — для таких групп поднимается свой ретранслятор. -
03
Модель для оракула — по желанию
API выбранного провайдера или локальная модель.
Связаться с автором
Хотите провести
свою пару в Colloq?
Напишите, что преподаёте и как устроено занятие: подскажу, с чего начать и какое окружение собрать. Ошибки и пожелания удобнее заводить issue на GitHub.
Написать Александруsleep3r@icloud.com