PowerTraderAI+ - Desktop GUI User Guide
Overview
The PowerTraderAI+ desktop application (pt_hub.py) provides a comprehensive graphical interface for managing your cryptocurrency trading operations with multi-exchange support.
Main Interface
Layout Overview
┌─────────────────────┬──────────────────────────────┐
│ Controls/Health │ Price Charts & Analysis │
│ │ │
│ • Neural: Status │ • BTC Price Chart │
│ • Trader: Status │ • ETH Price Chart │
│ • Exchange: Status │ • Portfolio Performance │
│ • Account Info │ • Trade History │
│ • Training Panel │ • Neural Levels Overlay │
│ │ │
└─────────────────────┴──────────────────────────────┘
Status Indicators
System Status
- Neural: running/stopped - Neural network analysis engine
- Trader: running/stopped - Automated trading engine
- Exchange: Connected KRAKEN - Primary exchange connection status
- Last status: [timestamp] - Most recent system update
Exchange Status Icons
- Connected EXCHANGE_NAME - Connected and operational
- Limited EXCHANGE_NAME - Connected but limited functionality
- Failed EXCHANGE_NAME - Connection failed or unavailable
- Checking… - Status verification in progress
- Start All - Launch neural analysis and trading systems
- Stop All - Safely shutdown all trading operations
- Train Selected - Train neural network for selected cryptocurrency
- Train All - Train neural networks for all configured cryptocurrencies
Settings Configuration
Opening Settings
Menu Bar → Settings → Open Settings Dialog
Core Trading Settings
Trading Configuration
- Main Neural Directory: Location of neural network models
- Coins: Comma-separated list of cryptocurrencies to trade
- Trade Start Level: Neural confidence level required to start trades (1-7)
- Start Allocation %: Initial percentage of portfolio per trade
- DCA Multiplier: Dollar-cost averaging multiplier for additional buys
- DCA Levels: Price drop percentages for additional purchases
- Max DCA Buys: Maximum DCA purchases per 24 hours
Profit Management
- Profit Margin (No DCA): Target profit percentage without DCA
- Profit Margin (With DCA): Target profit percentage when using DCA
- Trailing Gap: Percentage gap for trailing stop losses
📁 File Paths
- Hub Data Directory: Location for trade history and logs
- Neural Runner Script: Path to neural analysis engine
- Trainer Script: Path to neural network trainer
- Trader Script: Path to automated trader
Exchange Provider Settings
Regional Selection
Purpose: Determines which exchanges are available based on regulatory compliance
Options:
- 🇺🇸 US - United States regulated exchanges only
- 🇪🇺 EU/UK - European Union and UK compliant exchanges
- 🌐 Global - All supported exchanges worldwide
Available Exchanges by Region:
| Region |
Available Exchanges |
| 🇺🇸 US |
Robinhood, Coinbase, Kraken, Binance.US, KuCoin |
| 🇪🇺 EU/UK |
Kraken, Coinbase, Binance, Bitstamp, KuCoin |
| 🌐 Global |
Binance, Kraken, KuCoin, Coinbase, Bybit, OKX |
Primary Exchange Selection
Purpose: Your main trading exchange for order execution
How it works:
- Select your region first
- Dropdown automatically filters to compliant exchanges
- Choose your preferred exchange
- System validates availability and credentials
Advanced Exchange Options
- 🔍 Price Comparison Enabled: Compare prices across multiple exchanges before trading
- Auto Best Price: Automatically route orders to exchange with best prices
- Exchange Setup: Launch credential configuration wizard
UI Refresh Settings
- UI Refresh Seconds: How often the interface updates (default: 2.0)
- Chart Refresh Seconds: How often price charts update (default: 10.0)
- Candles Limit: Maximum number of price bars to display (default: 500)
Startup Options
- Auto Start Scripts: Automatically start trading systems when app launches
Exchange Setup Wizard
Accessing the Setup Wizard
- Settings Dialog → Exchange Provider Settings
- Click 🔧 Exchange Setup button
- Follow interactive prompts
Setup Process
1. Exchange Selection
Available exchanges for your region:
1. Robinhood (Commission-free)
2. Coinbase (Beginner-friendly)
3. Kraken (Professional)
4. Binance (High liquidity)
5. KuCoin (Wide selection)
Select exchange number: 3
2. Credential Configuration
For API-based exchanges (Kraken, Binance, etc.):
Enter Kraken API Key: your_api_key_here
Enter Kraken API Secret: your_secret_here
Test connection? (y/n): y
✅ Connection successful!
For login-based exchanges (Robinhood):
Enter username: your_username
Enter password: your_password
Enable 2FA device ID? (optional): device_id
Test connection? (y/n): y
✅ Authentication successful!
3. Verification
- Connection Test: Verifies API credentials
- Market Data Test: Confirms price feed access
- Balance Check: Validates account access
- Trading Permissions: Checks order placement capabilities
📈 Trading Operations
Starting Trading Systems
Prerequisites
- ✅ Exchanges Configured: At least one exchange set up with credentials
- ✅ Neural Models Trained: Complete training for your selected cryptocurrencies
- ✅ Account Funded: Sufficient balance for trading operations
Training Neural Networks
- Select cryptocurrency from “Train coin” dropdown
- Click Train Selected for single coin
- Or click Train All for all configured cryptocurrencies
- Wait for completion - status shows in training panel
- Verify readiness - “Training: READY (all trained)” appears
Starting Operations
- Ensure all training complete - “Start All” button becomes enabled
- Click Start All to begin operations
- Monitor status indicators:
- Neural: running ✅
- Trader: running ✅
- Exchange: ✅ CONNECTED
- View real-time data in charts and trade history
Monitoring Active Trading
- Account Value Chart: Portfolio performance over time
- Individual Coin Charts: Price movements with neural level overlays
- Trade History Table: Recent buy/sell transactions
- Current Positions: Open trades and profit/loss status
- Neural Levels: Visual indicators of AI confidence levels
Key Metrics Dashboard
- Total Account Value: Current portfolio worth
- Holdings Value: Value of cryptocurrency positions
- Buying Power: Available cash for new trades
- Percent In Trade: Portion of portfolio actively trading
- Realized Profit: Completed trade profits/losses
🚨 Error Handling & Troubleshooting
Common Status Messages
Exchange Status Issues
- ❌ Connection failed → Check internet, exchange API status, credentials
- ⚠️ Limited functionality → Some features unavailable, trading may be restricted
- Checking… → Initial connection attempt, wait for completion
- ❌ Authentication failed → Verify API keys, check permissions
Trading System Issues
- Neural: stopped → Training incomplete or system error
- Trader: stopped → Exchange issues or insufficient funds
- Training: REQUIRED → Must train neural networks before trading
- Flow: Train All required → Complete training before starting operations
Recovery Actions
For Exchange Problems
- Check Settings → Verify region and exchange selection
- Test Credentials → Run Exchange Setup wizard
- Try Alternative Exchange → Switch to backup exchange
- Check Exchange Status → Visit exchange website for maintenance
For Trading Problems
- Stop All Operations → Click “Stop All” button
- Review Logs → Check error messages in interface
- Retrain Networks → Click “Train All” if models corrupted
- Restart Application → Close and reopen pt_hub.py
- Adjust Refresh Rates → Increase refresh intervals in settings
- Reduce Candle Limit → Lower number of chart bars
- Close Unused Charts → Remove extra cryptocurrency tabs
- Check System Resources → Monitor CPU and memory usage
🔧 Advanced Configuration
Custom Neural Network Settings
Edit neural network parameters in individual coin directories:
main_neural_dir/
├── BTC/
│ ├── neural_trainer.py
│ └── config.json
├── ETH/
│ ├── neural_trainer.py
│ └── config.json
Multi-Exchange Price Optimization
Enable advanced features in settings:
- Price Comparison: See prices across all configured exchanges
- Auto Best Price: System automatically chooses best execution
- Smart Order Routing: Splits large orders across multiple exchanges
Custom Trading Strategies
Modify trading parameters per cryptocurrency:
- Individual DCA Levels: Different strategies per coin
- Coin-Specific Allocation: Varying portfolio percentages
- Custom Profit Targets: Individual profit margins
📱 Integration & Extensions
External Monitoring
Connect external tools to PowerTrader data:
hub_data/
├── trader_status.json # Current trading status
├── trade_history.jsonl # Complete trade log
├── account_value_history.jsonl # Portfolio performance
└── pnl_ledger.json # Profit/loss summary
API Access
Programmatic access to trading data:
import json
# Read current status
with open('hub_data/trader_status.json') as f:
status = json.load(f)
print(f"Active positions: {len(status.get('positions', []))}")
# Monitor account value
with open('hub_data/account_value_history.jsonl') as f:
for line in f:
data = json.loads(line)
print(f"{data['timestamp']}: ${data['total_value']}")
Custom Notifications
Set up alerts for trading events:
- Large Profit/Loss: Configure thresholds for notifications
- Exchange Disconnections: Immediate alerts for connection issues
- Training Completion: Notifications when neural networks finish training
- Order Execution: Confirmations for buy/sell transactions
🛡️ Security Best Practices
Credential Management
- Secure Storage: Credentials encrypted in
credentials/ directory
- File Permissions: Restrict access to credential files (chmod 600)
- Regular Rotation: Update API keys periodically
- Backup Credentials: Store securely offline
Trading Safety
- Start Small: Begin with minimal allocations for testing
- Monitor Actively: Don’t leave system unattended initially
- Set Limits: Configure maximum trade sizes and DCA limits
- Regular Backups: Save neural network models and configurations
System Security
- Updated Software: Keep PowerTrader and dependencies current
- Secure Environment: Use dedicated trading computer/VM
- Network Security: Secure internet connection, consider VPN
- Access Control: Limit who can access trading systems
PowerTraderAI+ Desktop GUI - Your comprehensive cryptocurrency trading command center.