Aller au contenu

Contribuer

HYDRA × PDX est un projet de recherche open-source. Les contributions sont les bienvenues.

Démarrage

git clone https://github.com/VOTRE_USERNAME/hydra-pdx.git
cd hydra-pdx
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python -m pytest tests/

Domaines où l'aide est nécessaire

Haute priorité

  • Nouveaux personas — Concevoir des simulations de cibles supplémentaires (ex : serveur santé, pipeline CI/CD, nœud Kubernetes)
  • Patterns PromptGuard — Étendre la bibliothèque de patterns regex avec de nouvelles techniques d'injection
  • Commandes built-in — Ajouter des sorties réalistes pour les commandes pas encore dans la liste des 65+ built-in (priorité : Docker, Kubernetes, systemd)
  • Couverture MITRE ATT&CK — Étendre le pattern matching au-delà des 20+ patterns actuels

Priorité moyenne

  • Améliorations extension Burp — Meilleure extraction de deltas, support WebSocket, analyse GraphQL
  • Générateurs supplémentaires — Nouveaux formats de fine-tuning (ex : ORPO, KTO)
  • Dashboard — Une interface web pour surveiller les sessions HYDRA en temps réel

Guidelines

  • Python 3.10+ — Utilisez les type hints, dataclasses et f-strings
  • Tests — Ajoutez des tests pour les nouvelles features. Lancez pytest avant de soumettre
  • Commits — Format conventionnel : feat: add Docker persona, fix: VFS mkdir race condition
  • Pas de vrais credentials — Ne committez jamais de vraies clés API ou mots de passe
  • Usage éthique — Ce projet est pour la recherche et l'éducation en sécurité

Soumettre des changements

  1. Créez une branche : git checkout -b feat/docker-persona
  2. Faites vos changements, ajoutez des tests
  3. python -m pytest tests/ — tous les tests doivent passer
  4. Committez et ouvrez une Pull Request contre main

Documentation

Pour les traductions françaises, créez un fichier avec le suffixe .fr.md à côté de la version anglaise. Par exemple : docs/hydra/overview.md → docs/hydra/overview.fr.md.

cd hydra-pdx-docs
pip install -r requirements.txt
mkdocs serve

Questions ?

Ouvrez une Discussion GitHub ou contactez-nous sur LinkedIn.