Short illustrated guides

CoCalc Guides

Narrative guides for using CoCalc-AI in real research, teaching, and software work, where files, notebooks, terminals, chat, and agent threads are collaborative by default.

Illustrated workflow for polishing a paper with LaTeX, Jupyter, and Codex
Math writing From Notebook to Paper

Polish a LaTeX draft with Codex, Jupyter, collaborators, and project history in one workspace.

Read the guide
Illustrated workflow for installing software in a CoCalc-AI project
Project setup Installing Software in CoCalc-AI

Use the terminal, Codex, apt, language packages, snapshots, and shared terminal history to make a project environment work.

Read the guide
Illustrated CoCalc Python workflow from Jupyter notebook to model.py to paper.tex with terminal, package environment, and Codex
Python workflow Python in CoCalc

Move from notebook exploration to reusable scripts, real Linux package work, Codex-assisted debugging, and figures in papers.

Read the guide
Illustrated workflow for using GitHub and pull requests from CoCalc-AI
GitHub workflow Using GitHub from CoCalc-AI

Install gh, authenticate, and let Codex help with issues, pull requests, releases, and reviews.

Read the guide
Illustrated workflow for managing long-running research computations
Research runs Research Runs That Survive

Let Codex manage logs, retries, partial outputs, summaries, and recovery for messy computations.

Read the guide
Illustrated workflow for publishing and reusing a CoCalc-AI RootFS image
Reusable environments Creating and Managing Your Own RootFS

Publish exact software stacks for courses, teams, sites, and public library demos with versions, scans, and rollback.

Read the guide
Illustrated CoCalc-AI Codex chatroom with collaborators, files, notebooks, terminals, images, and durable logs
Agent chat Using Codex Agent Chat in CoCalc-AI

Use durable, collaborative Codex threads with rich prompts, images, automations, search, and project-native tools.

Read the guide
Illustrated workflow where agent commits are reviewed commit by commit with line comments sent back to Codex
Git review Reviewing Agent Commits in CoCalc-AI

Use the git review drawer to inspect every agent commit, mark coverage, ask line-level questions, and avoid vibe coding.

Read the guide
Illustrated CoCalc Jupyter notebook workspace with collaborators, Codex, TimeTravel, widgets, and backend run state
Jupyter notebooks CoCalc Jupyter Notebooks

Use durable execution, realtime collaboration, TimeTravel, Codex, widgets, nbgrader, and whiteboard graph cells in one project.

Read the guide
Illustrated CoCalc teaching dashboard connected to live student projects with assignments, chat, TimeTravel, nbgrader, and shared environments
Teaching Teaching with CoCalc-AI

Understand CoCalc as a live computational classroom with student projects, assign/collect workflows, nbgrader, TimeTravel, and shared environments.

Read the guide
Illustrated CoCalc terminal with a shared work.term file, collaborators, Codex, project files, and side chat
Terminal work The CoCalc Terminal

Understand the terminal as a durable collaborative project document: `.term` files, shared streams, side chat, splits, and agent-aware CLI tools.

Read the guide
Illustrated Launchpad self-hosted CoCalc-AI site connected to projects, collaborators, clouds, and user-controlled data
Self-hosting Self-Hosting CoCalc-AI

Run Launchpad for a small team, bring your own compute and security policy, then step up to Rocket when scale demands it.

Read the guide
Illustrated CoCalc Plus workspace on a laptop with one project, local files, terminal, notebook, and Codex chat
Personal CoCalc CoCalc Plus

Install a free, self-contained one-user CoCalc on a laptop, workstation, or SSH machine, with remote launch and folder sync.

Read the guide
Illustrated map of CoCalc for Jupyter users with nearby notebook tools
Notebook landscape CoCalc for Jupyter Users

Compare CoCalc with JupyterLab, Colab, Deepnote, SageMaker, VS Code, marimo, Hex, Kaggle, and other notebook-centered tools.

Read the guide
Illustrated map of CoCalc for LaTeX users with nearby LaTeX tools
LaTeX landscape CoCalc for LaTeX Users

Compare CoCalc with Overleaf, VS Code, TeXstudio, TeXShop, LyX, AUCTeX, Tectonic, Typst, and other LaTeX workflows.

Read the guide
Illustrated map of CoCalc as a durable collaborative project cloud for humans and agents
Agent sandbox cloud CoCalc for Agent Sandboxes

Understand CoCalc as a durable collaborative Linux project cloud for agents and humans, distinct from public app hosting.

Read the guide
Illustrated overview of CoCalc-AI architecture with browser, bay, project host, control plane, and direct project connection
Architecture How CoCalc-AI Works

Learn the mental model behind bays, project hosts, direct browser routing, off-runtime sync, R2/Rustic storage, and Rocket scale.

Read the guide