Resources / Course / Chapter 01

Your Investment AI Needs a Home

8 min read

Why a chat window is not enough for real investment work, and what changes when the AI gets a computer.

What you will leave with
  • Why a stateless chat AI is the wrong tool for ongoing investment work
  • The two-analyst metaphor: chat-only vs. AI with a computer
  • What this course is, what it is not, and the permanent design pattern
  • How the five chapters of Phase 1 are organized and what to expect

Most demonstrations of AI in investing happen inside a chat window. You type a question, the model writes a paragraph, you read it, the conversation ends.

That is fine for playing around. It is not enough for actual investment work.

Real investment workflows need a place to keep things: data files, research notes, scripts that crunch numbers, scheduled jobs that run after market close, a hosted dashboard a teammate can open, and a record of what was done and why. They also need a place where those pieces keep running after a conversation ends, with the same files and tools available the next time you log in.

That is the premise of this course. Zo Computer is the home for your investment AI.

If you are new to Zo, the simplest description is this: it is a personal cloud computer that you can talk to in plain English. You can also open files, run scripts, host pages, and schedule jobs on it. The AI lives inside that environment, so when you ask it to do something, it has files, tools, and services it can actually use — not just words it can generate. The Zo intro docs cover the surface area in detail.

Why a chat window is not enough

To see why the home matters, picture two analysts.

The first analyst is brilliant but lives in a soundproof room. You can pass notes under the door, and they pass thoughtful answers back. They know finance deeply and can reason about almost anything. But they cannot pull up a Bloomberg page, open a 10-K, run a backtest, or check yesterday’s close. Whatever they tell you about a specific number or recent event, they are guessing — politely, but guessing.

The second analyst sits at a desk in your office. They have a laptop, market data, your firm’s research folder, a terminal, a set of internal tools, and a printer. When you ask “what does the latest 10-K say about insider transactions?”, they pull up the filing, find the section, and quote it back with a page reference. When you ask “where is SPY trading relative to its 200-day moving average?”, they run a script that calculates it.

The first analyst is what you get from a plain chat. The second is what you get from an AI with a computer.

This course is about giving your AI the second job.

What this course is not

This course is not about asking a model to pick stocks, predict prices, or generate trades. Models are bad at all three of those things, and pretending otherwise is how investment AI projects fail.

It is about building a controlled system where an AI can:

  • call code that returns exact, reproducible numbers
  • read primary-source filings instead of guessing what they say
  • explain the result in plain language a colleague can use
  • run on a schedule, leaving an audit trail behind
  • notify you when something matters enough to look at

The goal is not autonomy for its own sake. It is leverage with control. AI proposes, code computes, sources substantiate, humans decide. That sentence is the most important idea in the course. You will see it again.

How the course is structured

Phase 1 has five chapters. The first two get you set up. The next three build the mental model you will use everywhere else.

ChapterWhat it covers
01 IntroductionWhy a chat window is not enough, and the design pattern that anchors everything else.
02 PrerequisitesA Zo account, the areas inside Zo you should know, and a one-prompt install of Clarion.
03 Foundations 1Zo as the home: files, tools, surfaces, scheduled jobs. The four-layer mental model.
04 Foundations 2Setting up the workspace: folders, secrets, channels, hosting, browser.
05 Foundations 3Persistent context: USER.md, MEMORY.md, and how to give the AI a working memory.

Every chapter follows the same five-step pattern:

  1. Learn the concept. Read the short reading.
  2. Use it on Zo. Run the exercise. The first time through, you should not have to write code.
  3. Inspect the output. Read what the tool actually returned.
  4. Identify the guardrail. What stops the AI from making something up here?
  5. Decide what a professional version would require. What would need to change before you trust this with real capital?

Each chapter is roughly 30 minutes of reading and 30 minutes of hands-on. You can move faster or slower; the structure is here to help, not pressure you.

What ships later
Phase 2 will add chapters that build on this base — reading the market regime, valuing the market against history, and asking questions of indexed SEC filings. They use the same install you set up in Chapter 02 and the same workspace and memory layout you build in Chapters 03 to 05.

A note on jargon

You will see terms like regime, hurdle rate, RAG, deterministic tool, and audit trail throughout the course. We define each of them on first use, and the glossary at the end of the course has plain-English entries for everything. If a sentence reads like alphabet soup, the next paragraph almost always unpacks it. You are not missing anything; we are just trying to be precise.

The permanent pattern

Every chapter reinforces one design pattern. It is worth memorizing now:

AI proposes. Code computes. Sources substantiate. Humans decide.

Everything else — the folder structure, the tool design, the audit trail, the scheduled agent — is in service of that sentence. By the end of Phase 1, you should be able to explain why each piece of the pattern is there, and what goes wrong when one of them is missing.

Let’s get started. Continue to Chapter 02 — Prerequisites.