GME

---

About GME

Start 2026
Official mirror of Global Market Essentials

GME is a professional financial analysis tool.
The backend is implemented in C++, while the frontend uses Python with Django.

This repository primarily focuses on building AI-driven diagnostic systems across the financial sector.
The goal is to provide robust, scalable, and precise models for market, risk, and data analysis.

---

Execution Guide

1. Clone the Repository

git clone https://github.com/<yourname>/GME.git
cd GME

---

2. Initialize the Python Environment (uv)

bash scripts/init_project.sh

This will:

• Create .venv/ (managed by uv)
• Install dependencies from pyproject.toml
• Generate or update uv.lock for reproducible builds

---

3. Build the C++ Backend

bash scripts/build_backend.sh

---

4. Run the Backend

bash scripts/run_backend.sh

---

5. Start the Django Frontend

bash scripts/run_frontend.sh

Frontend will be available at:

http://127.0.0.1:8000/

---

6. Start Full Stack (Backend + Frontend)

bash scripts/full_start.sh

---

7. Run Tests

Backend (C++):

cd backend/build
ctest

Frontend (Python/Django):

cd frontend
uv run pytest

---

Repository Tree

GME/
│
├── backend/                             # C++ Backend Engine
│   ├── include/                         # Header files (.h / .hpp)
│   ├── src/                             # Source files (.cpp)
│   ├── tests/                           # Unit tests (GoogleTest or Catch2)
│   ├── CMakeLists.txt                   # Build configuration
│   └── README.md
│
├── frontend/                            # Python + Django Frontend + AI Modules
│   ├── gme_frontend/                    # Django project root
│   │   ├── settings/
│   │   ├── templates/
│   │   ├── static/
│   │   └── __init__.py
│   │
│   ├── ai_modules/                      # AI/ML logic for financial diagnostics
│   │   ├── models/                      # ML/DL models
│   │   ├── pipelines/                   # Data prep + inference pipelines
│   │   └── utils/                       # Shared utilities
│   │
│   ├── tests/                           # Django / PyTest test suite
│   ├── manage.py                        # Django entrypoint
│   ├── pyproject.toml                   # uv configuration & dependencies
│   └── uv.lock                          # Reproducible dependency lockfile
│
├── .venv/                               # Auto-generated by uv (DO NOT COMMIT)
│
├── docs/                                # Technical documentation
│   ├── architecture.md
│   ├── cpp_backend.md
│   ├── python_frontend.md
│   ├── ai_systems.md
│   ├── api_design.md
│   ├── file_naming_conventions.md
│   └── roadmap.md
│
├── scripts/                             # Executable scripts for local development
│   ├── build_backend.sh                 # Build C++ backend via CMake
│   ├── run_backend.sh                   # Run the compiled backend binary
│   ├── run_frontend.sh                  # Run Django server through uv
│   ├── full_start.sh                    # Start backend + frontend together
│   └── init_project.sh                  # Initialize uv environment + install deps
│
├── .gitignore                           # Ignore .venv, build artifacts, etc.
├── LICENSE
└── README.md

License

This project is licensed under the Apache 2.0 License.