Joining with a link
Open the /s/… link your teacher gave you and enter your name. You don't need an account, an email address or Python on your computer. Stay in the same browser: part of your identity and your local drafts are tied to it.
The /admin address is for teachers. colloq.ru/docs/ is documentation; it does not connect you to a class. If you only have the server address, ask your teacher for the link to your room.
What's on the screen
- Notebook — code, text, run results and other participants' cursors.
- Files — the room's data and documents. The file you have open may differ from the document on the shared screen.
- Oracle — questions to the AI and its answers, if it is enabled for the class.
- People — who is in the room right now; the panel is on the left, next to the files.
- Terminal — the room's shared shell: everyone sees its output, and you can type commands if the teacher allows running code.
On a narrow screen the side areas open as panels. Close them with their button or Esc to get back to the notebook.
Working in the shared notebook
In a standard class, cell edits and output are visible to the whole group. Code runs in the shared kernel: changing a variable or a file affects everyone who runs code after you. Check with your teacher before you restart the kernel or clear output.
If an action is unavailable, read the note next to it. The teacher may have kept it for themselves, locked the cell for now or ended the class. Reloading the page does not change these rules.
Your own answer in a Council
When the teacher opens a task in Council mode, edit your own sheet and send your answer with Submit. To change a submitted answer, click “Edit”. If the teacher allows running code, “Run” puts your attempt in the queue, either right away or after the teacher approves it; otherwise you will see “the teacher runs this one” next to it. That queue is the notebook kernel’s shared one, or, when the class’s council computes on machines, the queue of a pool of workers, where attempts run at the same time. The group does not see your answer until the teacher shows it. The teacher can reply to you and show a chosen solution to everyone, with your name or a variant number.
Your own sheet does not mean your own Python kernel. Code runs in the runtime of the whole room, but each attempt gets personal copies of its data, so changing a table or a list does not reach the next person. In the notebook’s kernel, files on disk and anything the server could not copy stay shared — when that happens, your output says so by name. On a pool of workers on machines, an attempt computes on a snapshot of the notebook, reads the class files and writes into a folder of its own: the files it writes come to its card, where you can download them. More in Council.
After class
The link of an ended class still opens the saved work for reading. A /p/… link opens the class page: the materials your teacher put up — notebooks with their run results, slides, data. You read a notebook right on the page, can copy code from its cells and download each notebook as .ipynb with its results; you can't run it on that page. “Download all” gives you every material in one archive, at the same paths as in the room, so the code finds its data after unpacking.
If you were in the class, the page has a “Class room” block with a “Go to the room” button: the edit history, the marks and the questions to the oracle are still there. Usually the button shows only in the browser you joined from.
A course link, /c/…, is the timetable by day: what happened last time, what is next, and every class of the term with a link to its page. Bookmark it: materials usually appear there on the day of the class, after it ends. While a class is on, the course page also has an “Enter the room” button — if you have joined the room from this browser before.
If the connection drops
Wait for the page to reconnect, then check that your last text is there. The connection, output and code execution depend on the server being reachable; closing the tab does not stop Python. Don't send the same run over and over. If the server is unreachable, send your teacher the page address, the time and the error text, but no personal sign-in links.