> For the complete documentation index, see [llms.txt](https://doc.lockerprotocol.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.lockerprotocol.com/hyper-agentic-trader/set-up-in-steps.md).

# Set up in a few steps

From an empty terminal to the daily pilot playing in simulation every day, one step at a time.

This is the page to follow from zero, in a terminal. At the end, the daily pilot plays one day every day on a simulation account that fills on Hyperliquid's real order book, and you can read every step it took. Moving it to your real account is one more command, when you have seen it work.

The application does the same steps on its screens, as its advanced install ([The application](https://doc.lockerprotocol.com/hyper-agentic-trader/application.md)); this page is the terminal's words for each of them.

Nothing here risks money, except the deposit. Inside `lpa setup` the deposit is everything you sent to the account on Arbitrum, so send only what you mean to trade with.

This page follows Locker Vault, the safest way to sign. With your browser extension or your mobile wallet, each step that the phone signs is a request you approve in your wallet; step 3 says where the two differ.

{% hint style="info" %}
**One command walks the whole way.** `lpa setup` does the setting up on its own, in nine steps: this computer, your model, your account (and how it signs), some funds, your password and the trading key, your limits, the limits you sign, round the clock, and the daily pilot in simulation. It says where it is (`Step 4 of 9 · Some funds`) and skips what is already done. If a step stops, for any reason, run `lpa setup` again: it takes up where it stopped. On a computer already set up it changes nothing, and a "no" you gave (the service, the service fee, the model, the pilot) is kept and not asked again.

On a machine with no screen, over SSH, the service comes before your model and your account, because the signing pages go through its console; setup says so when it reorders the steps. See [Install on a server](https://doc.lockerprotocol.com/hyper-agentic-trader/install-on-a-server.md).

With no wallet and no money: `lpa setup --paper` opens a simulation account instead and leaves out the account, the funds, the key and the signed limits. It still asks for a model, and still ends on the daily pilot.
{% endhint %}

{% stepper %}
{% step %}

### Check the computer

```sh
lpa doctor
```

What it says: one line per check, then the step to take next. On a fresh machine most lines read `-`, which means "not set up yet", not "broken".

What to check: the `node` line (22.13 or later) and the `hyperliquid` line, which must answer and report a clock drift of less than 10 seconds. The `account` line says `no vault account yet: lpa setup sets it up`, and the `assistant` line says `no model set: the pilot and orders in plain words need one`: both are steps of the one command below.

Details: [Install lpa](https://doc.lockerprotocol.com/hyper-agentic-trader/install.md)
{% endstep %}

{% step %}

### Start the setup, and give the pilot a model

```sh
lpa setup
```

Step 1 is the computer, read again. Step 2 is the model, and setup explains it before asking anything: the program does not come with an AI model of its own. The pilot, and orders you ask in plain words, think with one. Four ways, the first one first:

1. **The model included with your Hyper Agentic Trader plan.** Nothing to paste: your sign-in is its key. Connect the terminal first, with `lpa hyperkeel login`, and setup recommends it. 50 credits a month on the free plan, and a day of the daily pilot costs about 0.3 credit.
2. **A provider you pay yourself.** Open an account at Anthropic, OpenAI or Google, add a few dollars of credit, and create an **API key**: a long password that lets the program use the model in your name. Setup gives the page where a key is made at each of them. With `claude-sonnet-5` at Anthropic, a day of the daily pilot costs about 9 cents when it deliberates, and under one cent when no market is on the table.
3. **A model on your own computer**, free: LM Studio or Ollama. Nothing you write leaves the machine; it needs a recent computer and answers more slowly.
4. **Later**: setup goes on without one, and the pilot waits for it.

Say yes to open the settings page. In the Assistant card press **Edit** and choose the provider. For the included model, **Hyper Agentic Trader** is first in the list and asks for no key: choose `hat-fast`, press **Use this model**, then **Done** at the top of the page. For a provider of your own, paste the key and press **Save key**: the list of models fills, the recommended one first with its price (`claude-sonnet-5 (recommended) · $2 in, $10 out`); choose it, **Use this model**, **Done**. The terminal goes on. A key stays on this computer, in a file only you can read. About a minute.

What the screen says:

```
Step 2 of 9 · Your model
The pilot thinks with hat-fast (hat): about 0.3 credit a day of the daily pilot when it deliberates, counted on your plan.
```

or, with a provider of your own:

```
Step 2 of 9 · Your model
The pilot thinks with claude-sonnet-5 (anthropic): about $0.09 a day of the daily pilot when it deliberates, paid to the provider.
```

What to check: the price beside the model. The prices of the models of Anthropic, OpenAI and Gemini, and the reference price of the included model, are known to the program: there is nothing to type for them. A model on no list (OpenRouter, a server of your own) is yours to price in the **Cost** panel; without a price the pilot plays no day, since it cannot weigh its own cost.

Details: [Models and costs](https://doc.lockerprotocol.com/hyper-agentic-trader/models-and-costs.md), [Plans and credits](https://doc.lockerprotocol.com/hyper-agentic-trader/plans-and-credits.md)
{% endstep %}

{% step %}

### Choose how your account signs, and link it

Step 3 asks how you want to sign for your account, Locker Vault first:

```
Step 3 of 9 · Your account
How do you want to sign for your account?
  1. Locker Vault, the safest, recommended: a free app on a phone kept offline signs by QR; the key never touches a device that is online.
  2. Your browser extension (MetaMask, Rabby): it signs on a page this computer opens in your browser.
  3. Your mobile wallet (MetaMask, Rabby, Coinbase Wallet...): you scan a WalletConnect QR once, then approve each request on the phone.
The trading key and your limits are the same whichever signs.
Sign with Locker Vault, the safest? [y/N]
```

A yes takes Locker Vault. A no asks the next way, then the next; a no to all three stops setup, and nothing is kept. `lpa setup --with vault`, `--with browser` or `--with mobile` chooses at once. The choice is kept with the account, and `lpa signer use` changes it later for the same address ([How the account signs](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/setup-and-guardian.md#how-the-account-signs)). When this computer already read a Vault's sync QR, for another profile, setup first offers the accounts it saw that no other profile holds, one at a time, before it asks: a yes takes that account with the Vault and needs no second scan, a no goes on to the question.

**With Locker Vault**, the step opens a page on your own computer (`127.0.0.1`) and asks for the Vault's **sync QR**: on the Vault, open **Accounts**, pick the account, tap **Extension Sync**, then **Show the sync QR**. Hold the Vault up to the webcam: read in a few seconds. The sync QR carries every account the Vault holds, and `lpa` takes the first. To use another, run `lpa init --account 1` (or `--account 0x...`) before `lpa setup`.

**With your browser extension**, your browser opens the local page `http://127.0.0.1:7718`. Connect your extension there, for the account you trade with, on Arbitrum One: connecting signs nothing.

**With your mobile wallet**, the page and the terminal show a WalletConnect QR. Scan it with your wallet and approve the connection, for the account you trade with, on Arbitrum One.

With either of those two, one more signature follows, before any money: it moves nothing and grants nothing, and it proves your wallet signs for that address. It is checked on this computer and sent nowhere. An address that is a contract (a smart wallet) is refused. An account that already trades on Hyperliquid from MetaMask is linked as it is.

An account that already holds funds on Hyperliquid goes straight on: the same ceremony asks the password and the trading key of step 5, and the terminal says so ("Hyperliquid sees this account funded: the password and the trading key follow now, in the same ceremony"). Steps 4 and 5 then read as done.

What the screen says, with the Vault:

```
Step 3 of 9 · Your account
Account 0x3f5C...f0bE saved. The phone holds its key; this computer never will.
```

With an extension or a mobile wallet, the line reads *Your wallet holds its key; this computer never will.* A step already done reads on one line: `Step 3 of 9 · Your account: done. ...`. Addresses and hashes are shortened on this page; the terminal prints them in full.

What to check: the address on the screen is the one your wallet shows. Only the public address travelled. No key, ever.

{% hint style="info" %}
The Vault's sync QR is the same one the Locker Protocol Wallet extension reads. You do not need that extension to use `lpa`, and the Vault's own page says so.
{% endhint %}

Details: [Get Locker Vault for the agent](https://doc.lockerprotocol.com/hyper-agentic-trader/get-locker-vault.md), [Three ways to sign](https://doc.lockerprotocol.com/hyper-agentic-trader/agent.md#three-ways-to-sign-for-your-account)
{% endstep %}

{% step %}

### Fund the account

Hyperliquid refuses every action of an account it has never seen funded, so this step comes before the trading key. Setup says the two ways and waits for either:

1. **You already have USDC on Hyperliquid**: send some to that address from your Hyperliquid account (app.hyperliquid.xyz, Send). No bridge, no fee in ETH, and it is there within seconds. Setup sees it and goes on; nothing is deposited and your wallet signs nothing.
2. **From an exchange or a wallet**: send at least 5 USDC on the **Arbitrum One** network to that address, and a little **ETH** on Arbitrum One too (0.0005 is plenty): the deposit to Hyperliquid pays its fee in ETH. Setup waits for the USDC, then for the ETH, then deposits **all of it**. The deposit is a movement of funds, so your account signs it. With the Vault, the page shows the request, the Vault shows it as a deposit to Hyperliquid, the webcam reads the answer. With an extension or a mobile wallet, you approve the deposit there, the wallet sends it itself, and `lpa` reads the transaction back on Arbitrum before it says it went.

To deposit only part of it, run the deposit yourself before `lpa setup`, which then sees the account funded and skips this step:

```sh
lpa perps deposit --amount 20
```

What the screen says:

```
Step 4 of 9 · Some funds
Your account is 0x3f5C...f0bE. Two ways to fund it:
  1. You already have USDC on Hyperliquid: ...
  2. From an exchange or a wallet: send at least 5 USDC on the Arbitrum One network ...
The daily pilot opens nothing below $120 on the account: its first step would be under Hyperliquid's smallest order. With claude-sonnet-5 it trades from about $324: the charter keeps the model's cost a small share of what a trade aims at. Orders you place yourself need $10 each. It waits for them here.
Deposit sent: Hyperliquid credits it in about a minute.
$320.00 are on Hyperliquid. Below $5 a deposit is lost, so setup never offers less.
```

What to check: how much to send. The daily pilot opens nothing below $120 (the first step of its ladder would be under Hyperliquid's $10 minimum order), and with the recommended model it trades from about $324. To place orders yourself, $10 each is enough. Never deposit less than 5 USDC: below that the bridge loses more than it carries, and `lpa` refuses the order.
{% endstep %}

{% step %}

### Choose a password, approve the trading key

Step 5 asks for a password of 10 to 1024 characters, twice. The new agent key is sealed on your computer with it, **before** anything is shown to your wallet, so an interrupted ceremony loses nothing. Keep the password: it is the one `lpa unlock` asks later, and a key sealed under a forgotten password cannot be opened (your funds are not in it; `lpa agent renew` approves a new key with your wallet, under a new password).

Then the page shows two requests for your wallet to sign, in this order:

1. **Approve a Hyperliquid trading agent.** The Vault names the key and its expiry, and says what the key can and cannot do. Read it. It can place and cancel orders; it can never withdraw.
2. **Authorize the Locker service fee.** A cap of 0.05 %, with its recipient. Refuse it, and orders simply go out without the fee; `lpa agent fee` asks it again when you want. An account that authorized it before is not asked again: the page's last step and the terminal say so.

With an extension or a mobile wallet, the wallet shows each request as raw fields: the page lists them first, field by field, each value explained in one line, so you know what you are about to see.

With the Vault, after each signature the page says **Read: you can lower the phone**. Lower it: an answer still in front of the camera is named, never taken for the next one.

What the screen says:

```
Step 5 of 9 · Your password and the trading key
The guardian can sign for 0x8c1f...9a2e until 2027-04-04, the longest Hyperliquid allows. It places and cancels orders, nothing else.
```

What to check: the page tells you, at every step, exactly what your wallet must show before you sign. **If your wallet shows anything else, refuse it there** (on the Vault, tap **Refuse**).

Details: [The guardian and the keys](https://doc.lockerprotocol.com/hyper-agentic-trader/guardian-and-keys.md), [Hyperliquid review screens on the Vault](https://doc.lockerprotocol.com/vault/sign-a-transaction/hyperliquid.md)
{% endstep %}

{% step %}

### Read your limits

Step 6 shows this computer's limits and asks you to keep them:

```
Step 6 of 9 · Your limits
These limits bound every order, whatever asks for it: Max order $100, leverage 3x, the main dex, 20 orders a day.
Keep them? [y/N]
```

They are checked by the command and again by the guardian before it signs. None of them is a loss in percent: since lpa 2.4.0 no share of a loss stops an order, and if the price falls the position is not cut. Keep them for now; `lpa policy show` lists them. To change one: `lpa policy set --max-order-usd 50`, or the Limits panel of `lpa config`, then `lpa setup` again. To see what they would do to an order before you place one, `lpa perps check` quotes it and says whether they let it through, signing and writing nothing.

Details: [lpa policy](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/policy.md)
{% endstep %}

{% step %}

### Sign the limits in your wallet

Step 7 of `lpa setup` signs a mandate that allows `trade` and `pilot`, for the agent key's own life, the same as:

```sh
lpa mandate sign --actions trade,pilot
```

The terminal lists every bound and asks. Then the ceremony page shows the same rows, and the Vault shows them again on a card of its own (an extension or a mobile wallet shows them as raw fields, which the page explains one by one):

```
  Account                            0x3f5C...f0bE
  Signed                             2026-10-06 09:30 UTC
  Agent key                          0x9d79...cac9
  Allowed                            orders from the agent, and orders the pilot decides itself, without asking you
  Largest order                      $100.00
  Highest leverage                   3x
  Markets                            any market
  Dexes                              main
  Orders per day                     20
  Opened per day, at most            $2000.00
  Service fee, at most               0.05%
  Fee recipient                      0x49ed...7517
  Valid until                        2027-04-04 09:30 UTC
Sign this mandate with Locker Vault? [y/N]
```

With another wallet, the last line says *with your browser extension* or *with your mobile wallet*.

What to check: read every row in your **wallet**, not only on the computer: on the Vault, its own card; with an extension or a mobile wallet, each raw field against the page's list. The mandate ends with the agent key, 180 days at most and never past it: the renewal of the key is the gesture that brings you back to read the limits. A shorter one is yours to sign (`--days 30`).

What it adds that the local policy cannot: a ceiling on what may be opened per day, the one recipient of the service fee, what the key may be used for, and an end date.

Without a ceiling of your own, `Opened per day, at most` is the largest order times the orders per day. Set one with `--max-notional-per-day 500`.

With `pilot` in the uses, the Vault explains what `pilot` allows, and the terminal then asks whether your phone did; answer no and the signed mandate is not kept. An extension or a mobile wallet shows only the word, so `lpa` explains it itself and asks your yes before the request leaves. The daily pilot's live day needs `trade` only; a pilot in simulation needs no mandate at all.

Details: [The mandate](https://doc.lockerprotocol.com/hyper-agentic-trader/mandate.md)
{% endstep %}

{% step %}

### Decide about running round the clock

Step 8 offers to run the guardian as a service of your system, with a small console of its own behind a second password.

Say **yes** if the daily pilot is to play its day every day on its own, on your computer as on a server: the schedule of the last step runs in the service, and nothing else plays a day when you are not there. Say no to learn with `lpa pilot run-now` by hand (`Skipped: nothing runs once you close this terminal.`); `lpa service install` adds the service later.

The service starts locked after every restart of the machine, since the key is never kept open on disk: `lpa unlock`, or its console, opens it again, and `lpa pilot status` says a day that could not start.

Details: [lpa service and lpa console](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/service-and-console.md)
{% endstep %}

{% step %}

### The daily pilot, in simulation first

Step 9 opens a simulation account of $1,000 when there is none, then has the service play the daily pilot on it every day, through the command that asks:

```
Step 9 of 9 · The daily pilot, in simulation first
The model runs at Anthropic. Your positions, the marks and the account address go there. A local model (LM Studio, Ollama) keeps everything here.
With claude-sonnet-5 a day costs about $0.09 of model when the pilot deliberates, and under one cent when no market is on the table ...
Below $120 on the account the first step is under Hyperliquid's smallest order, and the pilot opens nothing. ...
Have the service play the daily pilot every day at 00:30 UTC (02:30 on this computer's clock), in simulation? [y/N] y
The service plays the daily pilot every day, on a simulation account of $1000: nothing of your real account moves. `lpa pilot status` says where it is, `lpa pilot day` tells the last day; `lpa pilot schedule --on --live` moves it to your real account once you have seen it work.
```

The hour is the charter's, 00:30 UTC by default, counted by the service's own clock: no cron, no time zone, and a computer asleep at that time plays the day when it wakes.

Without the service, the step opens the simulation account and asks nothing:

```
Step 9 of 9 · The daily pilot, in simulation first
A simulation account of $1000 is open. Without the service nothing plays a day on its own: `lpa service install` then `lpa pilot schedule --on` has one played every day.
Setup complete.
No pilot is scheduled: `lpa pilot run-now` plays one day of the daily pilot now, `lpa pilot schedule --on` has the service play one every day.
To place an order yourself    lpa          then plain words, or /quote BTC long 0.001 3x
```

From the first command to "Setup complete", the whole way took about four minutes when we timed it, with the Vault.

What to check: `lpa pilot status` says the schedule, the next day and, later, the last day played. Nothing of your real account moves, and simulation mode stays as it was.

To see a day without waiting for the night, about half a minute and a few cents:

```sh
lpa pilot run-now
```

```
Day 2026-10-06_0302 in simulation with anthropic/claude-sonnet-5: no-trade.
No trade: 1 said none.
Steps: guard, dossier, reader, deliberations, vote. Files: ~/.lpa/pilot/days/2026-10-06_0302
Log: ~/.lpa/logs/pilot.log
```

With the default charter, whose longs open in the lower third of the week's range, a day without a trade is the usual answer, and several may pass without an order: the day names each market with where it sits in its week, and such days cost nothing. `opened` means a position was built; `refused` means the code refused what the model proposed, and the verdicts say which rule.

The day plays the strategy the charter names, `ladder-long` until you change it: the measured ladder, longs only, built by steps, with no stop. There are seventeen others, and you can write your own; change nothing yet, and read [The strategies](https://doc.lockerprotocol.com/hyper-agentic-trader/strategies.md) when you want to.

To watch one market decided now, without playing a whole day and without writing anything:

```sh
lpa pilot deliberate --symbol BTC
```

Details: [Your first simulation day](https://doc.lockerprotocol.com/hyper-agentic-trader/first-paper-day.md), [lpa pilot](https://doc.lockerprotocol.com/hyper-agentic-trader/commands/pilot.md)
{% endstep %}

{% step %}

### Read what it did

Three ways, from shortest to fullest:

```sh
lpa pilot status
lpa pilot day
lpa live
```

* `lpa pilot status` says the schedule, the last day, what the pilot holds, and whether the service runs.
* `lpa pilot day` tells the last day from its own files: the steps, the vote, every verdict with its figures, the order, and the balance once the position closes.
* `lpa live` opens the live page in your browser: every activity of this computer as it happens, its thinking, its tools and its orders.

On a day without a trade, `lpa pilot day` gives the two sentences that decided it: the climate the reader gave the day from the texts alone, and the trader's own reason for proposing nothing, in its own words (for example that BTC sat at 61 % of its week's range, where the charter opens longs in the lower third). A day without an order reads as a decision that was taken, with its figures, and not as something that failed.

`lpa journal` is the ledger: orders, refusals, deposits, and the fees paid.
{% endstep %}

{% step %}

### Later: the real account

When you have seen the pilot work in simulation for as long as you want:

```sh
lpa pilot schedule --on --live
```

It checks that the guardian holds the key (`lpa unlock`) and that the mandate is in force, says what a day costs and what the account must hold, and asks. From the next day the pilot plays on your real account, under the limits you signed. `lpa pilot schedule --off` plays no new day and keeps following what is held, to its exit.

To stop everything at once, whatever is running:

```sh
lpa panic
```

It stops every pilot and every copy, then takes the key out of memory. It closes no position and cancels no order: your positions stay yours.

Details: [Go live](https://doc.lockerprotocol.com/hyper-agentic-trader/go-live.md)
{% endstep %}
{% endstepper %}

## What "it worked" looks like

* `lpa status` names your account, an agent with 179 days left, a mandate in force, the model and what it cost today; the key reads `locked` until `lpa unlock`, and the last line says so (`next 'lpa unlock' gives the guardian the trading key, so it can sign your orders.`).
* `lpa pilot status` says the daily pilot is scheduled in simulation, with the next day's hour; or, without the service, the last day you played by hand.
* `lpa paper status` shows an equity near your budget.

## If something goes wrong

{% hint style="warning" %}

* *`NEEDS_DEPOSIT`*: not enough USDC, or no ETH for gas, on Arbitrum. Send a little of each to the account, or USDC straight to it on Hyperliquid.
* *`LOCKED`*: the guardian holds no key. Run `lpa unlock` in your own terminal. A wrong password says which password it is, and what to do when it is forgotten.
* *`AGENT_EXPIRED` or `AGENT_NOT_APPROVED`*: `lpa agent renew`, one signature in your wallet. Right after an interrupted approval, wait a minute: Hyperliquid may not list the agent yet.
* *`POLICY_REJECTED`*: the order is outside your limits, and the message names the limit it hit.
* *`NO_MODEL`*: no model is set up. `lpa config` explains where to get a key and which model to choose; connected to your account, the included model needs none.
* *`NO_CREDITS`*: the included model refused the call: the month's credits are spent, or the free plan's budget of the day. A bigger plan or a top-up on hyperagentictrader.com, a personal key or a local model in `lpa config`, or wait for 00:00 UTC.
* *`MANDATE_INVALID`*: the mandate is not one this account signed for this agent. Sign a new one in your wallet.
* *The ceremony page will not read the Vault*: more light, hold the Vault still, raise its screen brightness. Animated codes need a second or two. After a signature, lower the phone when the page says **Read**.
  {% endhint %}

## Next

{% content-ref url="/pages/TbCog6kvSuwboWSNvnBn" %}
[Your first simulation day](https://doc.lockerprotocol.com/hyper-agentic-trader/first-paper-day.md)
{% endcontent-ref %}

{% content-ref url="/pages/hBRMoy8i5CHfosIo5rmZ" %}
[Go live under the mandate](https://doc.lockerprotocol.com/hyper-agentic-trader/go-live.md)
{% endcontent-ref %}

{% content-ref url="/pages/r8WRYvuGaQv9h4FsA69e" %}
[Stop, and take your money out](https://doc.lockerprotocol.com/hyper-agentic-trader/leaving.md)
{% endcontent-ref %}

{% content-ref url="/pages/eYPGBWyBR2RmHsNLud1E" %}
[Safety rules for the agent wallet](https://doc.lockerprotocol.com/hyper-agentic-trader/safety-rules.md)
{% endcontent-ref %}
