AutoPlan on Windows — full walkthrough.

Step 1 — Install Python (one time, ~3 min)

AutoPlan is written in Python. Windows doesn't ship with it, so you need to install it once.

1. Go to python.org/downloads/windows.
2. Under Stable Releases, click the latest Python 3 release (3.12 or 3.13; anything 3.9+ works).
3. Scroll down to Files → click Windows installer (64-bit). Downloads a file like python-3.13.0-amd64.exe.
4. Open the downloaded file. Important: on the first screen, check "Add python.exe to PATH" at the bottom. Then click Install Now.
5. When it finishes, close the installer.

Verify it worked: press Windows + R, type powershell, press Enter. A blue terminal opens. Type:

python --version

You should see Python 3.13.0 (or whatever you installed). If it says "python is not recognized", you missed the PATH checkbox — re-run the installer, choose Modify, check the box.

Step 2 — Install Git (one time, ~2 min)

Git is the tool that downloads AutoPlan's code.

1. Go to git-scm.com/download/win. Download starts automatically.
2. Open the downloaded Git-x.x.x-64-bit.exe.
3. Click Next through all the defaults. Don't overthink them.
4. Close the installer.

Verify: back in PowerShell:

git --version

Expect git version 2.45.0.windows.1 or similar.

Step 3 — Download AutoPlan (~30 seconds)

Pick where on your computer AutoPlan should live. Your user folder is a safe choice. In PowerShell:

cd $HOME
git clone https://github.com/ELuria17/schedule-agent.git autoplan
cd autoplan

The git clone line downloads the project into a new folder called autoplan inside your user folder. The cd autoplan line steps inside it.

Step 4 — Install AutoPlan's dependencies (~1–2 min)

python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

Break-down:

• python -m venv venv makes a clean, isolated Python environment so it doesn't conflict with anything else.
• venv\Scripts\activate steps into it. You'll know it worked because your prompt now starts with (venv).
• pip install -r requirements.txt downloads every library AutoPlan needs. You'll see a lot of output; that's normal.

When it's done you should see a line like Successfully installed anthropic-0.96.0 caldav-1.3.9 ....

Step 5 — Launch AutoPlan for the first time (~30 seconds)

Before running the next command, have these two things ready:

• An Anthropic API key — sign up free at console.anthropic.com, click Create Key, copy the long string that starts with sk-ant-.... Keep it handy.
• Your iCloud app-specific password — go to appleid.apple.com, sign in, Sign-In and Security → App-Specific Passwords → +, label it "AutoPlan", copy the generated xxxx-xxxx-xxxx-xxxx code. This lets AutoPlan access your iCloud calendar without your real Apple password.

Then run:

python run.py

A few things happen:

1. The first time, Windows Firewall pops up a dialog asking whether Python should be allowed on the network. Click Allow (private networks is enough).
2. Your default browser opens automatically to a setup page — http://127.0.0.1:8787/setup.
3. Fill in the form:
   • Anthropic API key — paste the one you copied.
   • Calendar — iCloud, plus your primary Apple ID email and the app-specific password.
   • Task source — if you're a student with Canvas, Canvas + prompts. Otherwise None / manual only — you can type tasks into the hub directly.
   • Notifier — ntfy.sh is pre-selected. Copy the topic the wizard generates for you; you'll use it on your phone in a minute.
4. Click Save and create Anthropic agent.

When the success page appears, close the browser tab and go back to PowerShell. Press Ctrl+C to stop AutoPlan for a moment.

Step 6 — Get phone notifications (~2 min)

Install the ntfy app on your phone (free, no account):

• iPhone: apps.apple.com — ntfy
• Android: play.google.com — ntfy

Open the ntfy app, tap + to add a subscription, and paste the topic the setup wizard generated. Done — every morning summary AutoPlan sends will appear as a push notification on your phone.

The topic is a secret: anyone who knows it can both read and send messages on it. Don't share it.

Step 7 — Use AutoPlan day-to-day

Start it up whenever you want to use it:

cd $HOME\autoplan
venv\Scripts\activate
python run.py

Your browser opens to the hub at http://127.0.0.1:8787/hub?key=<your-token>. Bookmark it — that's the page you'll come back to every day.

When you're done, go to PowerShell and press Ctrl+C.

Making it easier to launch

AutoPlan comes with a file called run.bat that does all three of the above lines for you. You can:

• Double-click run.bat in File Explorer to start AutoPlan.
• Make a shortcut: right-click run.bat → Send to → Desktop (create shortcut). Now AutoPlan is one click from the desktop.
• Launch at login: press Windows + R, type shell:startup, press Enter. Drag the shortcut you made into the folder that opens. AutoPlan will start automatically whenever you sign in.

Troubleshooting

"python is not recognized"

You missed the "Add to PATH" checkbox during install (Step 1). Re-run the Python installer, click Modify, check the box.

"git is not recognized"

Close PowerShell and open a new window. If it still doesn't work, reinstall Git and make sure "Git from the command line and also from 3rd-party software" is selected during the installer.

The ntfy app doesn't receive notifications

• Check you subscribed to the exact same topic the setup wizard generated (it's in the .env file in the autoplan folder, under NTFY_TOPIC=).
• On iPhone: make sure notifications are on for ntfy in iOS Settings → Notifications → ntfy.

Windows SmartScreen blocks run.bat

If you see "Windows protected your PC," click More info → Run anyway. SmartScreen is cautious about unsigned scripts. This only happens the first time.

Something else broke

Open an issue at github.com/ELuria17/schedule-agent/issues with the exact error message copied from PowerShell.