Archiviz

Visualisation interactive et en temps réel de l'architecture de projets logiciels multi-langages.

Archiviz analyse votre code source et génère un graphe interactif de son architecture — dépendances, couches, modules, classes, fonctions — accessible directement dans le navigateur.

Fonctionnalités

• Analyse multi-langages : Python, JavaScript/TypeScript, Java, Go, Rust, C#, SQL, Docker
• Graphe interactif : navigation, zoom, filtres par type et par langage, recherche
• Temps réel : mise à jour automatique du graphe dès qu'un fichier est modifié
• Détection automatique : couches architecturales, dépendances cycliques, points de fragilité
• Assistance IA (optionnel) : réduction du bruit, détection de motifs, explications en langage naturel
• 100 % local : aucune dépendance cloud obligatoire

Installation

pip install archiviz

Requires Python >= 3.9

Utilisation rapide

# Analyser le répertoire courant et ouvrir l'interface web
archiviz start

# Analyser un projet spécifique
archiviz start --repertoire /chemin/vers/projet

# Changer le port (défaut : 8000)
archiviz start --port 9000

# Activer l'assistance IA
archiviz start --ia

Puis ouvrez http://localhost:8000 dans votre navigateur.

Options CLI

Utilisation programmatique

from archiviz import ModeleGraphe, GestionnaireAnalyse

modele = ModeleGraphe()
gestionnaire = GestionnaireAnalyse(modele)
gestionnaire.analyser_repertoire("/chemin/vers/projet")

print(f"Composants : {len(modele.noeuds)}")
print(f"Relations  : {len(modele.aretes)}")

Architecture du package

archiviz/
├── analyseur/          Adaptateurs par langage (Python, JS, Java, Go, Rust, C#, SQL, Docker)
├── graphe/             Modèle de graphe unifié (noeuds, arêtes, cycles)
├── serveur/            Serveur FastAPI + WebSocket
├── interface_web/      Interface HTML/CSS/JS (vis-network)
├── surveillance/       Surveillance du système de fichiers (watchdog)
├── assistance_ia/      Intégration IA (OpenAI, Anthropic)
└── utils/              Gestion des erreurs

Langages supportés

Dépendances optionnelles

# Outils de développement
pip install "archiviz[dev]"

# Assistance IA (OpenAI / Anthropic)
pip install "archiviz[ia]"

# Tout
pip install "archiviz[dev,ia]"

Développement

# Cloner et installer en mode édition
git clone https://github.com/archiviz/archiviz
cd archiviz
pip install -e ".[dev,ia]"

# Lancer les tests
pytest

# Linter
ruff check src/

# Formatage
black src/

Documentation

• Python
• JavaScript / TypeScript
• Java
• Go
• Rust
• C#
• SQL
• Docker
• Analyse d'un projet Python
• Analyse d'un projet Fullstack
• Utilisation de l'API programmatique
• Guide de publication PyPI

Licence

MIT — Copyright (c) 2026 Archiviz Team.
Voir le fichier LICENSE pour le texte complet.