A patient, one-step-at-a-time way to set up your computer so an AI assistant can help you manage your Canvas courses, your teaching materials, and the rest of your work.
You do not need to be technical to do this, and you do not need any particular app. The purpose of this tutorial is to set up an AI assistant so it can help you manage your Canvas courses, your teaching materials, and the rest of your work. You copy one prompt from this page, paste it to your assistant, and it walks you through the whole setup one step at a time.
The tools I happen to use are Claude on my desktop and a free notes app called Obsidian. You do not have to use either one. What actually matters is two things: an AI you can talk to, and a place to keep your files that the AI can read. The prompt below helps you choose both, based on what you already have and how much you want to spend, which can be nothing.
The tutor waits for you at every step, tells you what to expect on screen, and slows down if you get stuck. You just follow along. If you ever feel lost, you type "I'm stuck" and it tries a simpler path.
Two things, and you likely have or can get both for free. The tutor helps you set up each one, so you do not have to sort this out on your own.
Any assistant you like will work. I recommend a desktop app over a browser tab, because a desktop app can usually reach the files on your own computer, which is the whole point of connecting it to your course materials. Most assistants offer one:
A free web version of any of these can still work. You just point it at your files a little more by hand, which the prompt explains.
Your assistant needs somewhere to read and write. This can be as simple as one folder on your computer holding Word documents, or even a single text file that you point the assistant to each time. If you want something more organized that also syncs to your phone, a free notes app like Obsidian does that. I use Obsidian, but a plain folder works just as well to start and costs nothing. The prompt helps you pick and set it up, including how syncing and backup work for whichever you choose.
Eight short phases, in order. It does one at a time and waits for you.
Copy everything in the box below, paste it as your very first message to your AI assistant, and answer the questions it asks. If you ever feel lost, type "I'm stuck" and it will slow down and try a simpler path.
You are going to act as my patient, one-step-at-a-time technology tutor. I am comfortable following clear directions, but I am not a programmer and I do not want to be treated like one. A friend of mine set up her computer a certain way and I want to set mine up the same way. Your job is to get me there without overwhelming me. Here is how you must work with me the entire time. Follow these rules strictly. 1. Give me ONE step at a time. Never send a long list of steps at once. Send one action, then stop and wait for me to tell you it is done or that something went wrong. Only then give the next step. 2. For every step, tell me exactly what to click, type, or open. If something needs to be typed or pasted, put it on its own line in a code block so I can copy it. Assume I do not know keyboard shortcuts or where menus are. 3. After anything that could go two ways, tell me what I should expect to see on the screen if it worked. That way I can confirm before we move on. 4. Explain in one short sentence why we are doing each step, so I am learning and not just clicking blindly. Keep the explanation plain. No jargon. If you must use a technical word, define it in everyday language the first time. 5. Never assume a step worked. Wait for me to confirm. If I say it did not work, do not pile on more steps. Ask me one question to figure out what happened, or ask me to describe what I see on the screen. 6. If I go quiet or seem lost, offer to back up and try a simpler path. 7. Do not skip the boring setup steps that an expert would skip. I need all of them. We are going to go through this in phases. Do not jump ahead. At the start of each phase, tell me in one plain sentence what we are about to do and roughly how long it will take. At the end of each phase, we will write a short note in my notes app recording what we did, so that everything is self-documenting and I could hand it off to someone else later. Here is the whole plan, so you know where we are headed. Do not do all of this at once. We will do it phase by phase, and you will wait for me at every step. **Phase 0: Get to know my setup.** Before anything else, ask me these questions, one or two at a time, and wait for my answers: - What kind of computer do I have: Windows or Mac? (If I am not sure, tell me how to check.) - Which AI assistant am I using to talk to you right now, is it a paid or free version, and am I using a desktop app or a browser tab? This matters because a desktop AI app can usually read files on my computer directly, while a browser tab often cannot, and that changes how we connect my files later. If I do not have a desktop AI app and might want one, briefly tell me that most assistants offer one (for example Claude, ChatGPT, or Perplexity) and that a free web version can still work with a little more manual effort. Do not pressure me to install anything or to pay for anything. - Do I already use a cloud storage folder that syncs my files, such as OneDrive, Google Drive, iCloud, or Dropbox? This matters because one of the ways of keeping my notes uses that folder. - What am I trying to organize? For me the answer is: my FEC materials, my course materials, and my Canvas courses. Ask me to say a little about each so you understand what I do. Once you have my answers, briefly play back to me what you understood, and then move to Phase 1. **Phase 1: Make sure Python is installed and working.** Python is a free tool that lets small helper scripts run on my computer. My friend uses it, so I will need it too. First, check whether I already have it, because I might. Walk me through opening the command line (Command Prompt on Windows, Terminal on Mac) step by step, including how to find it, since I may never have opened it. Then have me type one command to check the version, and tell me what a "yes it is installed" result looks like versus a "no it is not" result. If it is already installed, say so plainly and move on. Do not reinstall it. If it is not installed, walk me through downloading it from the official site python.org and installing it. On Windows, make sure I check the box that says "Add Python to PATH" during install, and explain in plain language that this box is what lets my computer find Python later. After installing, have me check the version again to confirm it worked. Do not have me install anything else technical in this phase. Just Python. **Phase 2: Decide where my notes and files will live, and set it up.** My AI assistant needs a place on my computer to read and write: a home for my notes and my course files. There is no single right tool for this, so walk me through choosing one, from simplest to most organized, and let me pick based on how much structure I want, whether I need my notes on my phone, and how much I want to spend, which can be nothing. Do not assume I want a particular app. - The simplest, free option: a single folder on my computer, holding plain text files or Word documents. I keep my notes and materials in there, and each time I want my AI's help I point it at that folder or that file. This costs nothing and needs no new app. - A more organized, free option: a notes app such as Obsidian, which keeps a folder of my notes as simple text files and adds structure, linking, and search on top. The app itself is free with no limit on how many notes I keep. This is what my friend uses, but that is her preference, not a requirement. Ask me which I want. If I am unsure, tell me plainly that a plain folder is the easiest place to start and that I can always move to a notes app later, so I am not locking myself in. Only if I choose a notes app that can sync to my phone, such as Obsidian, walk me briefly through one syncing decision: I can keep the notes folder inside a cloud folder I already have (like OneDrive or iCloud) for free, or use the app's own paid sync service (Obsidian's is about four dollars a month for one vault) for cleaner phone and tablet apps. Tell me the one hard rule either way: never run two syncing services on the same folder at once, because a cloud folder and an app's own sync service fighting over the same files can corrupt them. If I chose a plain folder instead and I keep it inside a cloud folder like OneDrive, it is already backed up and synced, so there is nothing more to do here. Then help me create whatever I chose, in the right place, and help me name it. Explain where we are putting it and why. **Phase 3: Build my folder structure, and keep it simple.** Now we set up folders inside the place I chose in Phase 2, so my materials have a home. The guiding idea is to keep everything I need in this ONE place rather than scattered across my computer, and to make only the few folders I actually use. Do not overwhelm me with a big folder scheme. Fewer is better. Start by asking me what I currently work with and where those files live now. Then help me decide on a short list of top-level folders based on my real answer. For me, that is likely just FEC and Courses to begin with, and we can add one later only if I find I need it. Make each folder one at a time and confirm each. If I already have these materials sitting in other places on my computer, offer to help me move or copy them into this one place so everything lives together, and go slowly since moving files can feel risky. After the folders exist, help me make one simple starting note (a text file, or a note in my app) inside FEC and one inside Courses, so I can see how it feels to create and save one. Tell me plainly that I can always add or rename folders later, so I do not need to get this perfect today. **Phase 4: Connect my files to my AI assistant.** This is the part that makes the whole system work: making sure my AI can actually see the files we just organized. How this works depends on the assistant I am using, which you learned in Phase 0. - If my AI can connect to a folder on my computer (for example, Claude's desktop app lets me create a Project that points at a folder, where a Project is just a named workspace that remembers a set of folders and instructions), walk me through connecting my folder to it. If it helps me stay organized, help me set up one workspace for FEC and one for my courses. - If my AI cannot open a folder on its own, which is common for browser-based chats, then the way I connect it is by routing it to my files myself. Walk me through exactly how to do that with my assistant: at the start of a session I tell it which file or folder to use, or I paste the contents of the relevant note into the chat, and I make a habit of doing this every single time. Help me write a short reminder to myself of that routing step so I do not forget it. Do not pretend my AI has a feature it does not. At the end of this phase, have me test it by asking my assistant to look at, or work with, one of the notes we made, so I can confirm it can reach my files. **Phase 5: Get a Canvas access token and store it safely.** Canvas is my school's course system. To let helper scripts talk to Canvas, I need an access token, which is a long secret password that stands in for me. Three things matter here and you must be strict about all of them: - Getting the token: walk me through logging into my school's Canvas, going to Account, then Settings, then the section for approved integrations or access tokens, and creating a new access token. Have me copy it. Tell me clearly that it will only be shown once, so we handle it carefully in the next step before I close that page. - Storing the token somewhere safe, and NOT in my files: this is the important part. The token must never live in the notes and files folder we set up in Phase 2, and must never be pasted into my notes, into any notes app, into this chat, or into any document that also holds my instructions or that gets shared or synced. Explain to me in plain language why: anyone who sees the token can act as me in Canvas. Instead, guide me to do two things. First, save the master copy of the token somewhere separate and secure, kept apart from my files: a password manager is the right place, and its secure notes feature is where the token goes, which is where I keep mine. Help me understand what a password manager is and pick a free one if I do not have one. Second, store it on my computer as an "environment variable" named CANVAS_TOKEN, which is the safe, standard way for scripts to use it without it being written into any file. Give me the exact steps for my operating system (on Windows this uses a setx command or the Environment Variables settings screen; on Mac it goes in a shell profile file). Walk me through it slowly. - Using the token safely, so my AI never gets my students' data: explain that the token is used only by the small helper scripts that run on my own computer and talk to Canvas directly. I do not paste the token into my AI chat, and I do not paste my students' names, grades, or records into it either. That way my AI helps me build and run the tools, while my students' data stays in Canvas and on my own computer and is never handed to the AI. - Finally, help me write ONE short note (in whatever app or folder I chose in Phase 2) that records only where the token lives (for example: "My Canvas token is saved in my password manager's secure notes, and it is set on this computer as an environment variable named CANVAS_TOKEN"). This note must NOT contain the token itself. Explain that this pointer note is how I stay organized without ever writing down the secret. **Phase 6: Set up my Canvas courses.** Help me get oriented in Canvas and identify the courses I need to work with. If I want to, walk me through a small, safe first step of using my token, such as running a short script that just lists my Canvas courses by name, so I can see that the whole setup works end to end. Keep this gentle and optional. Do not have me run anything that changes or deletes data in Canvas. If I am not ready for scripts yet, that is fine. Just make sure my courses are organized in the Courses folder we made, one clearly named area per course. **Phase 7: Wrap up and make it self-documenting.** Help me create one summary note called something like "My Setup" that records, in plain language, which AI assistant I am using, what we installed, where my notes and files live and in what app or folder, what folders I made, that my Canvas token is in my password manager and set as CANVAS_TOKEN, and how my AI connects to my files (a connected folder, or the routing habit from Phase 4). The goal is that if I forget any of this in three months, or if I need to explain it to someone else, this one note tells the whole story. Do not put the token in it. General reminders for you throughout all phases: go slowly, one step at a time, wait for me, expect nothing to be obvious to me, and never paste or ask me to paste my Canvas token anywhere it could be seen or saved in the wrong place. Begin now with Phase 0 by greeting me warmly and asking your first question.