Getting started
Install an interface
Three steps on Ubuntu. Each interface then opens in your web browser.
Download
Get the .tar.gz archive for the interface you need from this site.
Extract
Unpack the file in your home directory, then open the folder that was created.
Start
Run the setup script once, then use ./DEMARRER.sh every time you start a session.
Example — QE Input Generator v1.2
tar -xzf generation_inputs-QE_v1.2_2026-09-18.tar.gz
cd génération_inputs-QE
./CONFIGURER.sh --yes # une fois (prérequis + chemins)
./DEMARRER.sh
# → http://127.0.0.1:5012/
# Pseudos .UPF dans pseudos/PBE (et PBE_FR si besoin)
Example — Pseudopotential Generator v1.3
wget https://github.com/hiadsi1959/interfaces-qe-hiadsi/releases/download/v1.3/generation_pseudos_v1.3_2026-09-15.tar.gz
tar xzf generation_pseudos_v1.3_2026-09-15.tar.gz
cd generation_pseudos
./configure.sh # une fois : prérequis + dépendances Python + chemins relatifs
./DEMARRER.sh # à chaque session
# → http://127.0.0.1:5008/
# Autonome : générateurs ld1 / APE / ATOMPAW / ONCV + lib/ dans ./bin/ et ./lib/
Example — Interface-QE v1.2
tar -xzf Interface-QE_v1.2_2026-09-03.tar.gz
cd Interface-QE_v1
./CONFIGURER-PC.sh --yes
./DEMARRER.sh
# → http://127.0.0.1:5007/interface/
# Fiches résultats : outputs/<matériau>/fiche_technique_*.{html,pdf,md}
Example — THERMO_PW v1.2
tar -xzf thermo_pw_v1.2_2026-09-04.tar.gz -C ~/
cd ~/thermo_pw
./config_autre_pc.sh # prérequis + chemins QE (une fois)
./DEMARRER.sh
# → http://127.0.0.1:8000/
Example — Supra-QE v1.4 · 2026-10-01
tar xzf supra-QE_v1.4_2026-10-01.tar.gz
cd supra-QE
./configure.sh --yes --qe-bin ~/q-e-qe-7.5/bin # prérequis système + venv + liens QE → bin/
# équivalent : ./INSTALL_AUTOMATIQUE.sh -y --qe-bin ~/q-e-qe-7.5/bin
./DEMARRER.sh
# → http://127.0.0.1:8765/interface/
# Pseudos NC (.upf) dans pseudos/ · archive sans outputs/ · XCrySDen pour la SF 3D (sur le PC API)
Example — QE–ALAMODE v1.3 · 2026-10-01 (fixed & tested on Nb)
tar -xzf QE-Alamode_v1.3_2026-10-01.tar.gz
cd QE-Alamode_interface
chmod +x configure.sh DEMARRER.sh ARRETER.sh
./configure.sh --install-deps # once : apt + Python (sudo)
./configure.sh --non-interactif -y # ./bin (pw.x, alm, anphon) + lib/ → config_local.sh
./configure.sh --check-only # diagnostic
# Parallelism (edit config_local.sh, then restart API) — e.g. i9 · 64 GB :
# OpenMP-only QE : QE_NPROC=1 OMP_NUM_THREADS=24
# MPI+OpenMP : QE_NPROC=8 OMP_NUM_THREADS=3
# Long 3×3×3 runs: QE_TIMEOUT=43200 (or higher; see forces preflight in UI)
./DEMARRER.sh
# → http://127.0.0.1:5020/
# Standalone pack if bin/pw.x + lib/ present · Ubuntu 24.04+ · pseudos .UPF in pseudos/
Note. Archive (~78 MB): pw.x, ALAMODE (alm, anphon, optional analyze_phonons)
and lib/ (LD_LIBRARY_PATH at startup). Python deps via configure.sh --install-deps.
Calculations run on your PC — this website is download only. Use ./DEMARRER.sh, never file://.
Example — Optimisation-QE v1.0 · 2026-09-26
tar -xzf optimisation-QE_v1.0_2026-09-26.tar.gz
cd optimisation-QE
chmod +x CONFIGURER.sh DEMARRER.sh ARRETER.sh
./CONFIGURER.sh --install-deps # une fois : python3 + flask/ase/numpy (sudo)
./CONFIGURER.sh # écrit config_local.sh (chemins relatifs, pw.x, pseudos)
# Parallélisme (éditer config_local.sh) : QE_NPROC=4 · OMP_NUM_THREADS=1 · QE_TIMEOUT=21600
./DEMARRER.sh
# → http://127.0.0.1:5030/
# Chaîne : VC-RELAX → RELAX → SCF · inputs bruts dans inputs/<Mat>/
# Après SCF : conducteur (N(EF) ≠ 0) ou gap (N(EF) ≈ 0) → conducteur = candidat Supra-QE
Note. Archive (~77 MB): pw.x (QE 7.5 MKL) + lib/ (LD_LIBRARY_PATH at startup).
Pseudopotentials .UPF in pseudos/ (Nb, Si included). Only Python 3 required —
Quantum ESPRESSO not required (bundled pw.x). Calculations run on your PC —
this website is download only. Use ./DEMARRER.sh, never file://.
Example — SQS-QE (Phases) v1.0 · 2026-10-20
tar -xzf SQS-QE_v1.0_2026-10-20.tar.gz
cd SQS-QE
chmod +x CONFIGURER.sh DEMARRER.sh ARRETER.sh
./CONFIGURER.sh # une fois : venv + chemins + liens QE / Optimisation-QE
./DEMARRER.sh # démarre l’UI (et l’API Optimisation-QE si besoin)
# → http://127.0.0.1:5031/
# Prérequis calculs : pack Optimisation-QE (ou clone ~/optimisation-QE) pour pw.x
Note. Archive compacte (~0,4 Mo) : interface + backend Flask SQS, exemples CIF/inputs.
Les binaires QE sont liés par CONFIGURER.sh depuis Optimisation-QE / QE installé.
Calculs sur votre PC — ce site sert uniquement au téléchargement. Utilisez ./DEMARRER.sh, jamais file://.
Installation détaillée — Pseudopotential Generator v1.3 sur un autre PC
(detailed setup on another machine)
L’archive generation_pseudos_v1.3_2026-09-15.tar.gz (~131 Mo compressés, ~300 Mo décompressés) est
autonome : elle contient l’interface web, l’API Flask, les
4 générateurs (ld1.x, oncvpsp.x, ape,
atompaw), pw.x, leurs bibliothèques dynamiques
(lib/ : MKL, Intel MPI, libxc, GSL) et les gabarits ONCV.
Sur le PC cible, seul Python 3 est nécessaire (Flask installé automatiquement) :
Quantum ESPRESSO n’est pas requis pour les 4 générateurs.
- Télécharger l’archive : bouton Download de l’interface 02, ou
directement l’asset de la Release GitHub
v1.3. Le fichier est hébergé sur la Release
(131 Mo, au-delà de la limite de 100 Mo par fichier du dépôt).
- Transférer le fichier sur l’autre PC : clé USB,
scp ou e-mail.
- Extraire dans le dossier personnel, puis entrer dans
generation_pseudos/.
- Configurer une seule fois avec
./configure.sh : il installe les
prérequis système (python3, python3-pip, curl,
lsof, ca-certificates, xdg-utils via sudo
non interactif) puis les dépendances Python (flask, flask-cors,
requests), supprime les liens cassés de bin/, vérifie que les binaires
se chargent avec lib/ (ldd), crée les 4 dossiers de sortie
(pseudos-ld1/, pseudos-APE/, pseudos-atompaw/,
pseudos-oncvpsp/) et écrit api_config.json en
chemins relatifs au projet — l’installation reste donc valide quel que soit
l’utilisateur ou le nom du dossier.
- Démarrer à chaque session avec
./DEMARRER.sh →
http://127.0.0.1:5008/ (arrêt : ./ARRETER.sh).
Ne jamais ouvrir index.html en file://.
# 1) Sur le PC cible — téléchargement depuis la Release GitHub
wget https://github.com/hiadsi1959/interfaces-qe-hiadsi/releases/download/v1.3/generation_pseudos_v1.3_2026-09-15.tar.gz
tar xzf generation_pseudos_v1.3_2026-09-15.tar.gz
cd generation_pseudos
# 2) Configuration de ce PC (une seule fois)
./configure.sh # prérequis système + pip + chemins relatifs + contrôle de lib/
./configure.sh --no-install # PC hors ligne : chemins seuls, aucune installation
./configure.sh --check-only # diagnostic, sans rien modifier
./configure.sh --qe ~/q-e-qe-7.5/bin # QE externe (facultatif : pw.x et ld1.x sont inclus)
./configure.sh --start # configure et démarre en une commande
# 3) Démarrage
./DEMARRER.sh
# → http://127.0.0.1:5008/
# 4) Bibliothèques UPF (facultatif, plusieurs Go, une fois par poste)
./TELECHARGER_BASES.sh --quick # ou onglet « Autres bases » de l’interface
# 5) Diagnostic complet sur ce PC
./verifier_installation.sh
Variante « un seul fichier ». ./build_installer.sh construit
dist/generation_pseudos (~105 Mo, même contenu en un fichier unique) :
chmod +x generation_pseudos && ./generation_pseudos installe dans
~/.local/share/generation_pseudos/app/, se configure selon la machine et ouvre
le navigateur ; --install ajoute la commande dans ~/.local/bin,
--reconfig reprend les chemins après un changement de machine ou de Quantum ESPRESSO.
À noter. Si vous déplacez le dossier ou changez de PC, relancez
./configure.sh (ou --reconfig) puis Ctrl+F5 dans le
navigateur pour purger les anciens chemins mémorisés côté client. Sur un PC vierge,
./configure.sh suffit : il installe lui-même python3-pip,
curl, lsof, les certificats TLS et un navigateur si nécessaire.
- « API hors ligne » / port occupé →
lsof -i:5008 puis ./DEMARRER.sh
(ou export GEN_PORT=5009).
- Page sans style ou sans tableau → URL
http://127.0.0.1:5008/, jamais file://.
- Chemins d’un autre PC dans
api_config.json → ./configure.sh
(purge puis redétection en chemins relatifs).
ldd bin/* renvoie « not found » → ./configure.sh ; sinon
bash scripts/vendor_generators.sh sur le PC source et retransférer lib/.
- Transfert réseau automatique :
./TRANSFERER_VERS_AUTRE_PC.sh --leger --dest utilisateur@IP -y.
- Guides complets :
docs/INSTALLATION_AUTRE_PC.md et
docs/TRANSFERT_AUTRE_PC.md (dans l’archive).
Installation détaillée — Supra-QE v1.4 sur un autre PC (PC de calcul)
· mise à jour 2026-10-01
Archive supra-QE_v1.4_2026-10-01.tar.gz (~0,6 Mo compressée) : interface web + API Flask,
générateurs d’inputs, explorateur de résultats, magnétisme v1.4 (SCF/NSCF),
base littérature (77 matériaux, références) et exports JSON / CSV pour IA,
chrono calculs, synthèse Résultats (voies), Aide théorique (MathJax). Sans dossier outputs/
(calculs recréés sur la machine cible). Quantum ESPRESSO 7.x doit être installé
séparément ; les binaires sont liés dans supra-QE/bin/, pas copiés en entier.
Matériaux magnétiques / SOC : prévoir un poste musclé (CPU/RAM).
- Télécharger via le bouton Download de l’interface 05 (fichier dans
telechargements/ du site).
- Extraire :
tar xzf supra-QE_v1.4_2026-10-01.tar.gz && cd supra-QE.
- Une seule fois :
./configure.sh --yes --qe-bin /chemin/vers/qe/bin
installe les prérequis Ubuntu (python3, python3-venv, pip,
curl, …), crée le venv Python, associe
pw.x, ph.x, q2r.x, matdyn.x,
epw.x, fs.x, wannier90.x, … via
scripts/associer_binaires_qe.sh.
- Chaque session :
./DEMARRER.sh → http://127.0.0.1:8765/interface/
(jamais file://).
- Pseudos Norm-Conserving (`.upf`) dans
pseudos/ · surface de Fermi 3D :
XCrySDen sur le PC qui exécute l’API (optionnel mais recommandé).
tar xzf supra-QE_v1.4_2026-10-01.tar.gz
cd supra-QE
./configure.sh --yes --qe-bin ~/q-e-qe-7.5/bin
./DEMARRER.sh
# Si epw.x manque : ./scripts/installer_epw.sh puis ./scripts/associer_binaires_qe.sh
# Guides : README.md, docs/workflow_supra.md, docs/AUTRE_PC.md
Installation détaillée — QE–ALAMODE v1.3 sur un PC de calcul
(materials science · phonons · κL) · 2026-10-01 · corrigé et testé sur Nb
Archive QE-Alamode_v1.3_2026-10-01.tar.gz (~78 Mo, sans résultats) : interface web + API Flask, chaîne complète
Optimisation → Calculs → Résultats, fiche technique, export outputs/.
Pack autonome si bin/pw.x, bin/alm, bin/anphon et lib/ sont présents.
Calculs 3×3×3 (κL publiable) : poste type i9 · 64 Go, plusieurs jours de CPU ;
régler QE_TIMEOUT, QE_NPROC, OMP_NUM_THREADS dans config_local.sh.
- Télécharger via le bouton Download de l’interface 06 (fichier
telechargements/QE-Alamode_v1.3_2026-10-01.tar.gz).
- Extraire :
tar xzf QE-Alamode_v1.3_2026-10-01.tar.gz && cd QE-Alamode_interface.
- Nouveautés 2026-10-01 : κe / κtot (Wiedemann–Franz), comparaison littérature (DOI) sur la fiche, légende des grandeurs, pré-vol IFC, reprise des forces (validé sur job Nb).
- Une fois :
./configure.sh --install-deps puis ./configure.sh --non-interactif -y
(écrit config_local.sh, vérifie ldd bin/*).
- Parallélisme (recommandé) : éditer
config_local.sh — ex. OpenMP seul
QE_NPROC=1, OMP_NUM_THREADS=24 ; ou MPI+OpenMP 8×3 si pw.x est compilé MPI.
- Chaque session :
./DEMARRER.sh → http://127.0.0.1:5020/ (arrêt : ./ARRETER.sh).
- Reprise après coupure : bouton « Reprendre les forces » ou
scripts/resume_job.sh <job_id>.
tar xzf QE-Alamode_v1.3_2026-10-01.tar.gz
cd QE-Alamode_interface
./configure.sh --install-deps
./configure.sh --non-interactif -y
# éditer config_local.sh (QE_NPROC, OMP_NUM_THREADS, QE_TIMEOUT / QE_TIMEOUT_CAP)
./DEMARRER.sh
# Parcours : Optimisation (VC-RELAX/SCF) → Calculs (supercellule, pw.x, alm, anphon) → Résultats
# Guides : README.md, GUIDE.md, README_DEPLOIEMENT.md (dans l’archive)