Guide

HyperAgent + Hyperliquid Platform Setup

Published 2025-11-23 • 12 min read

Pre-built scripts (`bin/env-shell.sh`, `run-script.sh`) and runbooks keep backend, brain, and frontend highly available.

1. Environment

Always run `/var/www/abtrading/perpfoundry/apps/api/venv/bin/python` with `.env` loaded before launching scripts.

abtrading-backend, abtrading-brain, abtrading-frontend, and abtrading-strategy all run with `Restart=always` and 15m timers.

`monitoring/error_watcher.py` tails backend_run_new.log and can alert Slack/SES for execution failures or depleted wallets.

Use `force_trade_test.py`, `verify_new_client.py`, and `/resources/live-pnl` to validate the pipeline end-to-end.

FAQ

How long does activation take?

Licensing + exchange connection takes under 10 minutes if you already have Hyperliquid API keys or a trustless signer running.

Can I run in simulation mode first?

Yes. You can run in simulation mode for as long as you need before going live on MAINNET. All transitions are auditable from Brain Control Center.

What reporting artifacts do I get?

Live dashboard metrics, `/resources/live-pnl`, HyperAlpha Daily emails, and exportable CSV/JSON for your fund admins.

Next steps

Want to see HyperAgent live or talk with a Solutions Architect?