THESIS docs
 v1.1.0
Live demo Get help
● Start · 10 minutes

Quick start
desk and admin running.

The shortest way from the zip to the landing page, the desk and the admin on your own computer. It assumes Node.js and pnpm are installed; if not, do Requirements first.

01Before you start

Which terminal

The commands on this page are written for the shell of macOS and Linux (bash or zsh). On Windows, run them in WSL (Windows Subsystem for Linux, Ubuntu) or Git Bash: commands such as cp, openssl, set -a && . ./.env and multi-line curl with \ do not work as written in PowerShell or cmd. The node and pnpm commands work in any of them.

  • node --version answers v22.12 or newer.
  • pnpm --version answers (these docs were checked with pnpm 10 and 12).
  • openssl version answers. It makes the admin secret; any other 32-byte random generator works too.
No keys needed to look around

Without an Anthropic key the desk still works: templates, JSON rules, the backtest, the robustness lab, paper runs and live runs. Only chart reading by AI is switched off.

02The ten minutes

  1. Unzip and open a terminal in the project folderCopy the source folder of the download somewhere without spaces, for example ~/projects/thesis, and open a terminal there. The folder contains package.json.
  2. Install packages
    pnpm install
  3. Make an admin secretCopy the 64-character answer; you need it in the next step.
    openssl rand -hex 32
  4. Start the desk and the API togetherReplace the placeholder with the secret from step 3.
    ADMIN_SECRET_KEY=<your-secret> pnpm dev
    Vite serves the pages on http://localhost:5180 and proxies /api and /admin to the API on port 8787.
  5. Copy the setup codeThis local start sets no ADMIN_SETUP_TOKEN, so the terminal prints a one-time setup code, once per start until an owner exists:
    [admin] No owner account yet. Open /admin and create it with this one-time setup code:
    XXXX-XXXX-XXXX-XXXX
  6. Create the ownerOpen http://localhost:5180/admin, enter the setup code, your email and a password of at least 12 characters, then press Create owner and sign in. On a server, set ADMIN_SETUP_TOKEN instead (Create the owner).
The dev server does not read .env

pnpm dev and the Node server take their settings from the environment of the terminal, not from a .env file. That is why the secret is written in front of the command here. For a server you keep running, see Installation → Settings file.

03What you should see

  • http://localhost:5180/ — the landing page with live Hyperliquid tickers.
  • http://localhost:5180/app — the desk, in Paper mode, with AI off in the top bar. Pick a template in the strategy gallery and press Load rules.
  • http://localhost:5180/admin — the admin. Status shows one failing warning, Anthropic API key accepted, until you add a key. Everything else passes on a fresh install.
Admin Status page with the Hyperliquid, storage and settings checks
Next

Continue with Installation: production build, a settings file, the AI key and your data folder. For a guided, no-code tour from here to a first testnet run, follow the First run walkthrough.