[wJubran]

What and why

The repository's main page only linked to the Arabic README, and both READMEs went from "install Python" straight to four commands. This PR:

• Arabic on the main page. README.md gets a short Arabic summary under the header, linked to a full Arabic section after the English text. That section covers what the project is, its main features, the requirements, step-by-step installation and running, and troubleshooting.

• Requirements table, in English and Arabic. It covers the OS, Python (64-bit, 3.10+, tested on 3.10, 3.12 and 3.13), memory, disk, browser and internet, plus the optional MetaTrader 5, Node.js and Git.

• Step-by-step guide, in both languages:

  1. Install Python.
  2. Get the code (git or ZIP).
  3. Create a virtual environment in the project folder, which is where the desktop app looks for it.
  4. Install the dependencies.
  5. Run on the simulator, or with MetaTrader 5: Algo Trading for orders, and TERMINAL PATH or LOGIN CREDENTIALS when it isn't found on its own.
  6. First steps in the terminal.
  7. Stop, restart, update and uninstall.

  It also covers the desktop app and has a troubleshooting table.

• The Arabic README has the same sections in place of its old two-minute section and separate desktop-app section.

The numbers come from a measured run:

• the backend uses about 135 MB on the simulator;
• the dependencies take about 470 MB;
• the first cone build takes about 30 seconds.

MetaQuotes publishes MetaTrader5 wheels only for 64-bit Windows, for Python 3.10–3.14, so the guide asks for 64-bit Python. The Arabic wording is chosen to avoid right-to-left rendering glitches, such as "bit-64" or brackets jumping around English commands.

How it was tested

• Rendered both READMEs with cmark-gfm (GitHub's Markdown engine) and GitHub's stylesheet, and checked the English and Arabic sections in screenshots. Anchors, tables, code blocks and right-to-left text render correctly.
• Checked every UI label quoted in the guide against the source (Settings → TRADING → LIVE TRADING, PROVIDERS → TERMINAL PATH / LOGIN CREDENTIALS) and every log message quoted (MT5 initialize() failed).
• python -m pytest tests/test_branding.py passes.
• UI changes: none.

Screenshots

Docs only.

---

Generated by Claude Code