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 stay on testnet?

Yes. Keep TESTNET active for as long as you need; switching to MAINNET is auditable and reversible 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?