ManualTrader/docs/setup.md

⚡ Setup Guide

5-minute setup for your Hyperliquid trading bot

📋 Prerequisites

• Python 3.11+ installed
• Hyperliquid account (testnet or mainnet)
• Telegram account

🚀 Installation

1. Clone & Install

git clone git@repo.codeskraps.com:codeskraps/ManualTrader.git
cd ManualTrader

python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. Create Telegram Bot

1. Message @BotFather on Telegram
2. Send: /newbot
3. Choose name: "My Trading Bot"
4. Choose username: mytradingbot_123_bot
5. Save the token (format: 123456789:ABCdefGHIjklMNOPqrs)

3. Get Your Chat ID

python utils/get_telegram_chat_id.py

• Enter your bot token
• Message your bot in Telegram (send "hello")
• Copy the Chat ID displayed in terminal

4. Configure Environment

cp config/env.example .env
nano .env  # Or use your preferred editor

Required settings:

# Get from Hyperliquid account settings
HYPERLIQUID_PRIVATE_KEY=your_private_key_here
HYPERLIQUID_SECRET_KEY=your_secret_key_here
HYPERLIQUID_TESTNET=true

# From steps above
TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_CHAT_ID=your_chat_id_here
TELEGRAM_ENABLED=true

5. Start Trading

python trading_bot.py

📱 Open Telegram → Send /start to your bot

🔑 Getting Hyperliquid Keys

Testnet (Recommended First)

1. Go to Hyperliquid Testnet
2. Connect/create wallet
3. Export private key from wallet settings

Mainnet (Real Money)

1. Go to Hyperliquid
2. Connect wallet
3. Export private key from wallet settings

⚠️ Never share your private keys!

✅ Verify Setup

# Test configuration
python -c "import sys; sys.path.insert(0, 'src'); from config import Config; Config.validate()"

# See sample statistics
python utils/demo_stats.py

🔧 Common Issues

"Configuration validation failed"

• Check all required fields in .env
• Ensure TELEGRAM_ENABLED=true

"Telegram bot not responding"

• Verify bot token with @BotFather
• Confirm Chat ID from script output
• Message your bot first before running script

"Import error"

• Activate virtual environment: source venv/bin/activate
• Install dependencies: pip install -r requirements.txt

🎯 Next Steps

Once setup is complete:

• Test with small amounts on testnet first
• Read the main README for usage instructions
• Check Project Structure to understand the codebase
• Review Deployment for production use

Setup complete! Your bot is ready for phone trading 🚀📱