ForexSmartBot

Professional-grade desktop application for automated forex trading with advanced risk management, multiple trading strategies, and real-time portfolio monitoring.

✨ Features

• Multi-Strategy Trading: 17+ built-in strategies including 7 ML-based approaches
• Real-time Monitoring: Live portfolio tracking with P&L updates and health checks
• Risk Management: Advanced risk controls with Kelly Criterion and drawdown protection
• Multi-Broker Support: Paper trading, MT4, and REST API integration
• Enhanced Backtesting: Comprehensive strategy testing with parallel processing
• GPU Acceleration: CUDA support for 5-20x faster ML training and inference
• Strategy Builder: Visual strategy construction with code generation
• Strategy Marketplace: Community-driven strategy sharing platform

🧭 Table of Contents

• Quick Start
• Installation
• Usage
• Configuration
• Documentation
• Contributing
• License

🚀 Quick Start

# 1) Install
pip install forexsmartbot

# 2) Run
python app.py

For detailed installation instructions, see docs/installation.md.

💿 Installation

From PyPI (Recommended)

pip install forexsmartbot

From Source

git clone https://github.com/VoxHash/ForexSmartBot.git
cd ForexSmartBot
pip install -r requirements.txt
python app.py

Optional TA-Lib / deep-learning / remote API stack:

pip install -r requirements-optional.txt
# or: pip install "forexsmartbot[talib,ml,remote]"

With GPU Acceleration (Optional)

# For CUDA 12.x
pip install cupy-cuda12x

# For CUDA 11.x
pip install cupy-cuda11x

See docs/GPU_ACCELERATION.md for detailed setup instructions.

With Native Rust Indicators (Optional)

Lower-memory SMA/ATR/RSI and parallel batch SMA via PyO3 (native/fsb_core). Requires Rust and maturin.

# once: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
pip install maturin
cd native/fsb_core && maturin develop --release

Without the extension, the same Python APIs use a NumPy fallback automatically. See docs/PERFORMANCE_TUNING.md.

🛠 Usage

Basic Workflow

1. Launch the application: python app.py
2. Configure settings: Go to Settings → General tab
3. Select strategy: Choose from available trading strategies
4. Set risk parameters: Configure risk per trade and leverage
5. Start trading: Click "Connect" then "Start Trading"

For advanced usage, see docs/usage.md and docs/cli.md.

⚙️ Configuration

Full configuration reference: docs/Configuration-Guide.md

📚 Documentation

• Getting Started: Quick Start Guide
• API Reference: Unified API Reference
• Architecture: System Architecture
• Data Providers: Provider Setup Guide
• Examples: Example Scripts
• FAQ: Frequently Asked Questions
• Troubleshooting: Common Issues

Complete documentation index: docs/INDEX.md

🗺 Roadmap

Planned milestones live in ROADMAP.md. For changes, see CHANGELOG.md.

🤝 Contributing

We welcome PRs! Please read CONTRIBUTING.md and follow the PR template.

🔒 Security

Please report vulnerabilities via SECURITY.md.

📄 License

This project is licensed under the terms in LICENSE.

🆘 Support

• Documentation: docs/
• FAQ: docs/FAQ.md
• Issues: GitHub Issues
• Email: contact@voxhash.dev

See SUPPORT.md for more support options.

⚠️ Disclaimer

This application is for educational and legitimate business purposes only. Users are responsible for complying with applicable laws and regulations. The developers are not responsible for any financial losses or misuse of this application.

Made with ❤️ by VoxHash Technologies