Quickstart

Prerequisites

Before you begin, make sure you have:

• A running Jupyter server (JupyterLab or Jupyter Notebook)
• Node.js 18+ installed
• An OpenAI API key for AI features

Installation

Install the Thesis CLI globally:

npm install -g @thesis/cli

Or if you prefer Bun:

bun install -g @thesis/cli

Connect to Jupyter

Launch Thesis Notebook and connect it to your Jupyter server. By default, it connects to http://localhost:8888:

thesis notebook

To connect to a different server:

thesis notebook --url http://your-server:8888

Your First Notebook

Once connected, you can create a new notebook or open an existing one. The interface should feel familiar if you've used JupyterLab before.

Try these keyboard shortcuts:

• Shift + Enter - Run the current cell
• Cmd + I - Ask the AI agent a question
• Cmd + K - Quick command palette

Next Steps

Now that you're set up, explore these guides:

• Core Concepts - Understand the key ideas behind Thesis
• Agent Modes - Learn about Ask, Plan, and Agent modes
• Monaco Editor - Get the most out of the code editor