yuzu.docsSiteOpen app
Start

Quickstart

From nothing to a presence that talks back — and remembers — in about a minute.

Everything in this section is the web app at app.yuzu.computer. No install, no keys. The CLI and API attach to the same presence once it exists — covered at the end.

Raise one

Open the app & sign in

Go to app.yuzu.computer. You land on an empty space — no presence yet, just the prompt to raise one.

Name it

A name, and one line of how it should be with you. This is not throwaway copy — it is written straight to permanent memory as the founding instruction. Write it like you mean it.

Pick a route

Choose the reasoning model. The default (claude-sonnet-4-6) is right for almost everyone; you can change it later with nothing lost — see Model routes.

Send the first message

It replies and keeps the thread server-side. Close the tab, come back tomorrow — it still knows you.

The first message

A good founding instruction is specific and durable — traits, not tasks. It will outrank things said in passing forever, so keep it to what should never drift:

founding instruction
You are Yuzu. Talk to me plainly, few words, no hedging. I trade on Base only. Never move funds over 0.05 ETH without asking, even if I told you to earlier.

Anything here becomes a pinned preference. Day-to-day facts don't belong here — just say them; memory will keep the ones that recur.

Give it a wallet (optional)

One click mints a Base wallet the presence can use. It comes up read-only: it can answer "how's the ETH/USDC pool" immediately, but cannot move anything until you fund it and set a spend policy.

Reading the chain is always safe to leave on — no policy, no risk. Spending is off until a policy explicitly turns it on.

Reach it from anywhere

The same presence, from a terminal:

shell
# once
npm i -g yuzu
yuzu login

# talk to the one you raised
yuzu chat

Or over HTTP — see API. There is no "create" call; the presence already exists.

Prove it remembers

The fastest way to feel what yuzu is: tell it something once, mention it again a few turns later, then come back tomorrow and reference it obliquely. The first mention starts a 7-day timer; the second pins it; tomorrow it's simply known. That mechanism is the whole of Memory.