GeezerVison is showing cocalc.ai — CoCalc Documentation | CoCalc CoCalc documentationProjects- Create a project
Create a durable Linux workspace for files, notebooks, terminals, chat, and agents. - Start and hand off a research task
Create and check a small analysis in Essential, save its context, and let a collaborator or viewer pick it up. - Project secrets
Store runtime credentials as encrypted, read-only files, select secrets to copy with the CLI, and check mount-refresh results. - Open a terminal
Use durable collaborative terminals backed by real project Linux processes. - Use a web browser with agents
A real web browser in your project that agents drive while you watch, take over, and hand back; it can also run on your own computer. - Use the projects page
Find, open, create, and organize the CoCalc projects you can access. - Publish project files
Publish an exact file, a folder, or the whole project with an unlisted signed-in share link. - Use task files
Use task files for shared checklists, project plans, and durable TODO lists. - Project images
Choose, customize, and reuse the Linux software stack for a project. - Create a project with RStudio
Create a CoCalc AI project with the RStudio and Jupyter image, then launch RStudio Server. - Publish project images
Publish project images with metadata, public slugs, discovery actions, app launchers, and CLI automation. - Add project collaborators
Invite collaborators or read-only reviewers, select visible files, and manage access as the work changes.
AI- Use the Agents workspace
Start an agent with a request, review its results, and continue the work from one workspace. - Agent features: Codex and Claude Code
Compare Codex and Claude Code workflows, payment methods, prerequisites, and current limitations. - Give an agent CoCalc access
Give an agent temporary access to selected CoCalc projects or all your projects. - Connect AI access
Choose membership, subscription, or API-key access for Codex and Claude Code, and configure keys for project code. - Open Codex chat
Use Codex inside a durable project workspace with files, terminals, and notebooks. - Claude Code in CoCalc
Use Claude Code in CoCalc: membership, subscription, or API-key access, project tools, billing, and permissions. - Agent memory
Let Codex and Claude Code keep short notes across sessions and projects: turn it on, see what agents see, and manage notes. - Configure Codex chats
Choose access, models, reasoning, speed, defaults, and parallel workers. - Guide and fork Codex conversations
Steer running work, queue follow-ups, send to existing threads from the CLI, choose a working directory, and fork context. - Goals and questions
Manage continuing objectives and answer blocking or asynchronous questions. - Watch for events with sensors
Schedule prompts for an agent, and let it watch for events with one-shot watchers or approved scripts that wake it. - Notifications and session activity
Choose completion notifications and inspect or stop ongoing Codex sessions. - Use Agent from an editor
Supply document context, select a conversation, review prepared prompts, and reuse generated images.
Research workflows- Reproduce a Python analysis in a fresh project
Run a complete example twice, compare input hashes and saved results, and record the research environment. - Analyze a CSV with streaming group statistics
Read a synthetic CSV one row at a time, check saved means and variances independently, and recognize incomplete results. - Move a Jupyter or Colab notebook into CoCalc
Transfer a notebook and its data, select the right kernel, replace platform-specific assumptions, and check a fresh run. - Resume a computation after interruption
Run a checkpointed Python example, deliberately fail it, resume unfinished cases, and verify the saved results. - Run and verify a bounded parallel CPU sweep
Compare one and two worker processes, check numerical integrals independently, and verify complete saved results. - Compile and verify a C numerical component from Python
Compile a C numerical routine, call it from Python, compare independent results, and retain source and build evidence. - Run a research analysis from your laptop
Upload inputs with the CLI, execute in a CoCalc project, inspect the remote result, and retrieve a checked artifact. - Recover research files and environments
Choose file history, snapshots, backups, or a clone, and practice restoring a checked copy without overwriting current work. - Share a private research dashboard
Launch a small managed HTTP app, verify readiness and collaborator access, inspect failures, and stop it. - Run and continue remote Codex tasks
Start a bounded CLI agent task, retain its continuation identifier, inspect sessions, and interrupt a selected task. - Run and verify a PyTorch GPU notebook
Check compute and CUDA software separately, calculate on a GPU, and save device and result evidence. - Create a reproducible R report with Quarto
Render a complete R analysis and plot to HTML, inspect the output, and preserve the inputs and environment for a collaborator.
CLI- Use the CoCalc CLI for automation
Use the CoCalc CLI for authenticated docs, browser, notebook, and project automation. - Get started with the CoCalc CLI
Install the CLI, sign in on your own computer, and inspect a project step by step. - CLI authentication and targets
Choose profiles, environment credentials, project context, browser targets, and fresh authentication. - Find the right CLI command
Navigate command families for files, notebooks, collaborative documents, agents, browsers, and operations. - Use the CLI in scripts
Parse JSON, check remote exit codes, and recover operations and asynchronous execution jobs. - Edit collaborative text with the CLI
Read, check, edit, and save live text with version and hash expectations. - Run and save notebooks with the CLI
Insert and run live notebook cells, inspect outputs, and recover detached runs. - Test browser workflows with the CLI
Resolve browser targets, inspect the supported API, verify UI actions, and recover asynchronous work. - Propose sensors with the CLI
How an agent sets watchers and writes, tests and proposes sensors with cocalc sensor. - Manage workspaces and notices with the CLI
Create and update workspace records, leave durable notices, and distinguish messages from agent turns. - Build documents and track CLI versions
Run complete document builds and distinguish CLI, server, browser, and agent-skill versions.
Terminal- Use terminals
Use persistent collaborative Linux shell sessions inside CoCalc projects. - Run graphical Linux applications
Launch Wayland and X11 applications, switch their windows, and connect terminals or notebooks to the graphical session. - SSH access to projects
Connect to cocalc.ai projects from a computer or another CoCalc project using SSH.
Files- Work with project files
Use the project filesystem as the shared place for notebooks, scripts, datasets, and output. - Use the file explorer
Create, open, upload, rename, move, and organize project files. - Use Markdown
Write README files, notes, instructions, math, code blocks, and collaborative documentation. - Create slides
Create presentation slides that live with the project files they explain. - Use whiteboards
Sketch diagrams, lecture notes, and visual plans in a collaborative project file. - Use TimeTravel
Inspect, compare, and recover the history of files in a project. - When a document's edit history can't be loaded
What CoCalc does when a file's, notebook's, or board's edit history is too large to load, and how to get to your file. - Use Git
Use Git for repository history alongside TimeTravel for file-focused recovery.
Troubleshooting- Jupyter kernel terminated
Recover from Jupyter kernels that crash, restart, or fail to start. - Project will not start
Identify maintenance, resource-pressure, disk-quota, and host-connection start blocks and choose the next check. - Low memory and out-of-memory crashes
Diagnose low-memory warnings, out-of-memory kills, and notebook kernel restarts. - Connectivity and browser troubleshooting
Diagnose sign-in, websocket, stale browser state, and network connection problems.
Python- Use Python in CoCalc
Use real Python through notebooks, scripts, terminals, virtual environments, and papers.
Self Hosting- Install CoCalc Star
Install CoCalc Star with one Docker command on macOS, Windows, or Linux; create the first admin; upgrade, back up, and remove it. - CoCalc Star on your own computer
Run CoCalc Star on your own computer with Docker Desktop for private, fast, offline-friendly work. - How to install Chromium
Install real apt-managed Chromium on Ubuntu from ppa:xtradeb/apps and prevent Ubuntu's snap transition package from returning. - Temporary SSH access to your computer
Temporarily let a trusted CoCalc project SSH back to your computer through a reverse SSH tunnel.
Project hosts- Choose compute for research
Compare project hosts, managed VMs, and remote kernels, then check machine fit, availability, permissions, and readiness. - Use project hosts
Run projects on dedicated or cloud-backed hosts and understand CPU sharing, RAM limits, and GPU access. - Manage project host access and RAM
Delegate host access and understand shared-pool tiers, private-host RAM defaults, and per-project caps. - Move projects between hosts
Move projects between hosts while accounting for backups, snapshots, region changes, and SSH. - Project host lifecycle actions
Understand start, stop, restart, drain, deprovision, and delete actions for project hosts. - Spot recovery strategy for project hosts
Explain spot retry windows, standard fallback, probes, and returning from fallback to spot. - What can change on a project host and when
Know which host edits are online, which require restart, and which require deprovision. - Understand project host reliability
Read host reliability, availability, outage exposure, planned downtime, and day-grid signals. - Project host software and daemon lifecycle
Understand runtime software, managed daemons, reconcile, upgrades, drift, and rollbacks. - Project host storage, backups, and snapshots
Understand host disk capacity, storage mode, backups, snapshots, and online disk growth. - How snapshots and backups work
How snapshots and backups work, their default schedule, what they guarantee, and what makes a backup slow. - Shared scratch disks on project hosts
Use host-scoped /scratch storage without confusing it with project storage, backups, or moves. - Inspect host metrics and logs
Interpret host metrics and logs to investigate resource pressure, provisioning, and runtime failures. - Use an exam scratchpad host
Set up, rehearse, run, and end an in-person exam on a private project host, with a clean, network-isolated notebook project for each student.
Teaching- Teach a course
Run computational courses with student projects, assignments, collection, grading, and feedback. - Course-sponsored compute
Understand course-funded student VMs, spending limits, and what happens when funding or storage retention ends. - Configure course student pay
Configure student pay, instructor-paid seats, site licenses, course start dates, and grace periods. - Restrict student projects
Explain each student-project restriction option and what it really disables. - Course shared project
Use a common writable project shared by all students, instructors, and TAs. - Course project images
Choose and roll out managed images for course projects. - Create a course assignment
Assign, collect, grade, and return computational work in student projects. - Use nbgrader
Use nbgrader for structured Jupyter notebook grading in CoCalc courses.
|