ForexSmartBot

ForexSmartBot — multi-venue desktop trading desk for forex, spot crypto (Binance / Kraken), and DEX swaps (1inch), with risk controls, strategy plugins, and real-time portfolio monitoring.

✨ Features

• Modern Trading Desk UI (3.4.0): Left nav, content stage, and session strip (equity / P&L / connection) with VoxHash dark branding
• App icon: Packaged window / notification / launcher icon (assets/icons/forexsmartbot_256.png + .ico) in VoxHash palette #0B0F14 / #3D9CF0 / #26C281
• Paper / sandbox venues (3.4.2): Venue Paper (live public prices + local fills) and Binance Spot Test Network sandbox orders
• Live opt-in (3.4.3–3.4.4): Binance + Kraken Spot mainnet via FSB_LIVE_TRADING=1 + dedicated live keys; kill-switch reuses RiskEngine
• 1inch DEX (3.4.5): Classic Swap quote + swap path with dry-run fills by default; on-chain broadcast double opt-in (FSB_DEX_BROADCAST)
• Wallet connect (3.4.6): MetaMask (WalletConnect URI / deep link) + Phantom Solana scaffold; chain registry (Ethereum, Base, Solana, Robinhood Chain, …); Settings → Wallet; session public address only
• 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

Linux app menu (Favorites)

After a local .venv install (pip install -e .), register the GUI in your desktop launcher:

./packaging/install-desktop.sh

Then open the app menu → All Applications or Office, find ForexSmartBot, and right-click Add to Favorites (or drag it onto Favorites).

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/EMA/ATR/RSI/MACD/Bollinger/Stochastic, parallel batch SMA, walk-forward / RSI / EMA / MACD / Bollinger / Stochastic sweeps, and multi-symbol equity aggregation via PyO3 (fsb_core). Install from PyPI or build from source:

pip install fsb-core
# or: 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
• v3.4.0 Shell: Modern Trading Desk
• v3.4.2 Paper/Sandbox: Venue Paper + Binance Sandbox
• v3.4.3 Live opt-in: Binance Live + kill-switch
• v3.4.4 Kraken Live: Kraken Live opt-in
• v3.4.5 1inch DEX: DEX aggregator dry-run execution
• v3.4.6 Wallet connect: MetaMask / Phantom / chains
• 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 GNU General Public License v3.0 or later (SPDX: GPL-3.0-or-later). See LICENSE.

Desktop builds depend on PyQt6 (Riverbank GPL-3.0, unless you hold a commercial PyQt license). The GPL copyleft matches that dependency for source and bundled installers. Trademark rights in VoxHash / ForexSmartBot names and logos are not granted by the GPL.

Not a lawyer / solicitor — professional review recommended before shipping a live-trading product.

🆘 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