⚡ MalXray – „Raze X” pentru Malware bazat pe Inteligență Artificială

MalXray este un sistem de analiză și vizualizare a malware-ului asistat de inteligență artificială.
Efectuează analiză statică și dinamică asupra fișierelor, apoi folosește un model LLM pentru a genera un raport ușor de înțeles și o reprezentare grafică interactivă a comportamentului.

---

🧩 Cerințe preliminare

Pentru Windows și Linux:

• Docker și Docker Compose
• O cheie API OpenAI (creează una la https://platform.openai.com/account/api-keys) sau foloseste pe cea de aici: https://pastebin.com/jYj26cHM cu parola "hackathonCraiova"
• Conexiune la internet pentru componenta LLM

---

⚙️ 1. Clonarea depozitului (repository)

git clone https://github.com/panterasbook29/Project-CvHackathon.git
cd Project-CvHackathon/malxray

---

⚙️ 2. Adaugă fișierul de mediu

Editeaza fisierul .env în directorul malxray:

OPENAI_API_KEY=sk-cheia-ta-aici

(Fără ghilimele, fără spații, fără „export”.)

---

🧱 3. Construiește și rulează cu Docker

🐧 Linux / macOS

sudo docker compose up --build

🪟 Windows (PowerShell sau CMD)

docker compose up --build

Așteaptă până când apare mesajul:

Uvicorn running on http://0.0.0.0:8000

---

🌐 4. Deschide interfața web

Accesează:
👉 http://localhost:8000

Vei vedea interfața MalXray:

• Poți încărca un fișier binar sau ELF
• Urmărești progresul în timp real
• Vezi „Povestea” generată de AI
• Explorezi graficul comportamental interactiv

---

🧰 5. Oprire și curățare

Oprire:

docker compose down

Reconstruire (dacă ai modificat codul backend):

docker compose build --no-cache

Curățare directoare de date:

sudo rm -rf data/uploads/* data/results/* data/logs/*

---

🧪 Opțional: Rulare fără Docker

Linux / macOS

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn backend.app:app --reload

Windows

python -m venv venv
.�env\Scripts�ctivate
pip install -r requirements.txt
uvicorn backend.app:app --reload

Apoi deschide http://127.0.0.1:8000.

---

🏁 MalXray — Vede dincolo de Malware. Înțelege amenințarea. Acționează mai rapid.