| <img width="1364" height="689" alt="image" src="https://github.com/user-attachments/assets/0544d213-c0a9-4c0f-9c7e-024823e8101c" /> | |
| ## Gemini 3 Flash AI Trading Platform - Walkthrough | |
| This guide explains how to run and use the autonomous AI trading platform powered by Gemini 3 Flash. | |
| ## Prerequisites | |
| - Python 3.10+ (with .venv activated) | |
| - Node.js 18+ | |
| - MetaTrader 5 Terminal (installed and running) | |
| ## 1. Configuration | |
| Ensure your .env file in backend/ has the correct credentials: | |
| ```ini | |
| MT5_LOGIN=YOUR_ID | |
| MT5_PASSWORD=YOUR_PASSWORD | |
| MT5_SERVER=YOUR_SERVER | |
| GEMINI_API_KEY=YOUR_KEY | |
| ACCOUNT_MODE=demo | |
| ``` | |
| ## 2. Starting the Platform | |
| **Backend (Python API + Agent)** | |
| Open a terminal in `backend/` and run: | |
| ```bash | |
| # Activate venv if needed | |
| .venv\Scripts\activate | |
| #locate | |
| cd backend | |
| #launch backend | |
| python -m uvicorn main:app --reload --port 8000 --host 0.0.0.0 | |
| ``` | |
| use backend because thats the directory name | |
| > You should see: Uvicorn running on http://0.0.0.0:8000 | |
| **Frontend (User Interface)** | |
| Open a new terminal in frontend/ and run: | |
| ```bash | |
| #locate | |
| cd frontend_react | |
| #launch frontend | |
| npm run dev | |
| ``` | |
| > You should see: Ready in ... at http://localhost:3000 | |
| ## 3. Using the Platform | |
| Open the App: Navigate to http://localhost:3000. | |
| Connection Status: Check the top header. You should see "CONNECTED" (green). | |
| If "DISCONNECTED", ensure the backend is running and MT5 is open. | |
| Start the Agent: | |
| Click the START button in the "Gemini Agent" panel. | |
| The AI reasoning sidebar will start streaming "thoughts" from Gemini 3 Flash. | |
| The agent will analyze the custom chart ticks and candles. | |
| Manual Trading: | |
| Use the BUY / SELL buttons to place trades manually. | |
| Set Volume, SL, and TP before trading. | |
| Open positions appear in the bottom panel. | |
| ## 4. Verification & Troubleshooting | |
| Backend Health Check: Visit http://localhost:8000/api/health. It should return {"status": "online", "mt5_connected": true, ...}. | |
| MT5 Connection: If the bridge fails to connect, ensure "Algo Trading" is enabled in MT5 and the credentials are correct. The backlog will show Connected to MT5. | |
| Gemini API: If the agent is silent or errors, check your GEMINI_API_KEY. | |