Your signals, executed on your own account.
From zip to live trading in about 15 minutes. Non-custodial: the bot runs on your machine, with your keys, on your Hyperliquid account — we never touch your funds.
You'll need three things
An active Observer membership with the Auto-Execution add-on, a computer (or small VPS) with Python 3.10+, and a Hyperliquid account with the funds you want to trade.
Nine steps, one time
Download your copy
~1 minuteUse the personal download link from your delivery email (or send /bot to our Telegram bot for a fresh one — links expire after 7 days). Unzip it anywhere — double-click on Windows/macOS. Your private feed token ships pre-configured inside, so don't share the folder with anyone.
Open a terminal in the bot folder
~1 minuteOpen your terminal (macOS: Terminal app · Windows: press Win, type “cmd”, Enter) and move into the unzipped folder. If you extracted it in Downloads:
cd ~/Downloads/observer-bot
cd %USERPROFILE%\Downloads\observer-bot
Install Python and the dependencies
~5 minutesYou need Python 3.10 or newer — download it from python.org (on Windows, tick “Add Python to PATH” in the installer). Then, from the terminal you just opened in the bot folder:
python3 -m pip install -r requirements.txt
py -m pip install -r requirements.txt
Launch the control panel
instantStart the panel and open http://127.0.0.1:8765 in your browser. It runs only on your machine (localhost) and never exposes anything to the internet. You should see your signal access with the days remaining, and a Test connection button — try it.
python3 app.py
py app.py
Create an agent wallet on Hyperliquid
~3 minutesIn app.hyperliquid.xyz go to More → API and create an agent wallet, then authorize it. Copy its private key. IMPORTANT: this is a trade-only key — an agent wallet can never withdraw or transfer your funds. Never, ever use your main wallet's private key.
Configure the bot in the wizard
~2 minutesIn the panel's wizard: your ACCOUNT ADDRESS is your main Hyperliquid wallet (the one holding the funds — not the agent's address; the bot double-checks this and refuses to go live if they don't match). Paste the agent's private key, then set your capital: base capital, risk per trade, leverage, max open positions and a daily loss limit.
Watch it in dry-run first
as long as you likeThe bot always starts in DRY-RUN: it connects to the live feed and logs every signal it would execute, without placing any order. Let it run until you've seen a few signals come through and you're comfortable with the sizing.
Go live
when you're readyFlip the DRY-RUN toggle off in the panel and confirm. From then on every signal executes automatically on your account. Start with a small base capital and scale up once you've watched it trade.
Keep it running 24/7
optionalThe bot only executes while it's running — a closed laptop means missed signals. For hands-off operation, run it on a small VPS ($5/mo works): the README inside the zip has a step-by-step guide including a systemd service that restarts it automatically.
Built so the worst case is boring
Non-custodial, always
The bot runs on your machine, trades your account with your agent key. We never see your keys and can never touch your funds. The code is open-source — inspect every line.
Trade-only key
Hyperliquid agent wallets can trade but can never withdraw or transfer. Even in the worst case, funds can't leave your account.
Built-in brakes
Max open positions, a daily loss limit that halts new entries, and a kill-switch: create a file named STOP in the bot folder and it stops opening positions immediately.
Your token is yours
Your feed token identifies you and expires with your paid period. When you renew, a fresh token lands in your Telegram automatically. Never share it — shared tokens get revoked.
If something doesn't look right
The bot says my token is expired or invalid
Your feed token renews with your subscription. Send /bot to The Observer bot on Telegram — you'll get a fresh token and a new personal download. Paste the token into the panel (or .env) and restart.
It refuses to start live with an 'agent not approved' error
Your ACCOUNT ADDRESS must be your main Hyperliquid wallet (where the funds are), and the agent wallet you created must be authorized for it. Check both in app.hyperliquid.xyz → More → API, then try again. This check protects you — without it the bot would trade blind.
It's connected but no signals arrive
Signals flow only while your base subscription is active, and only when the model actually trades — quiet stretches are normal. The panel's Test connection tells you the feed is reachable; if your subscription lapsed, renew and send /bot for a fresh token.
How much capital do I need?
Your call — the bot sizes each trade as a percentage of the base capital you configure (1% per trade by default, mirroring our model). Start small, watch it, scale when comfortable.
The panel doesn't open, or says the address is already in use
Another program on your machine is using port 8765. Start the panel on a different port: set UI_PORT=8799 (Windows) or UI_PORT=8799 python3 app.py (macOS/Linux), then open http://127.0.0.1:8799.
Can I run it on my phone?
No — it needs a computer (or a small VPS) with Python. A $5/month VPS is the recommended hands-off setup; the README walks you through it.
How do I update the bot?
Send /bot on Telegram for a fresh download and replace the folder (keep your .env). We announce important updates in the channel.
How do I stop it?
Ctrl-C stops the bot. To pause new entries while keeping it running, create an empty file named STOP in the bot folder — closes are always allowed, opens are blocked until you delete it.
Stuck? We'll get you running.
Reply to your delivery email or message our Telegram bot — setup help is part of the add-on.
Contact support →