Package overview¶
HyperTorch is organized as a flat Python package: the hypertorch/ package lives at the repository root rather than under src/.
.
├── .github # CI workflows and repository templates
├── Makefile # Common development, build, and test commands
├── docs # Documentation sources and generated site assets
│ └── agents # Agent reference documentation
├── examples # Runnable scripts for training and benchmarking
│ ├── hgnn.py # HGNN training and benchmarking example
│ ├── ... # Additional model examples
│ └── villain.py # VilLain training and benchmarking example
├── hypertorch # Main HyperTorch Python package
│ ├── data # Datasets, data loaders, and sampling
│ ├── hlp # Hyperlink prediction pipelines
│ ├── integration_tests # Integration test suite
│ ├── models # Model implementations
│ ├── nn # Neural-network layers and reusable modules
│ ├── tests # Unit test suite
│ ├── train # Training and benchmarking logic, and loggers
│ ├── types # Shared type definitions
│ └── utils # General-purpose utility functions
├── hypertorch_logs # Local logs and outputs from experiments
│ └── experiment_0 # Outputs produced by experiment_0
│ ├── comparison # Cross-model metric comparisons
│ ├── hgnn # HGNN-specific experiment results
│ ├── ... # Additional model-specific outputs
│ └── villain # VilLain-specific experiment results
├── pyproject.toml # Metadata, dependencies, and build settings
├── uv.lock # Lockfile for dependencies
└── zensical.toml # Documentation build and site configuration
Getting support¶
If you need help with HyperTorch, use these project channels:
- GitHub Discussions: ask questions, share ideas, and connect with the community.
- GitHub Issues: report bugs or request features (please check existing issues first).
Community¶
HyperTorch is developed as an open-source project with contributions from researchers and practitioners in the field of hypergraph learning. We welcome contributions of all kinds, including code, documentation, examples, and discussions. If you're interested in contributing, please visit the contributing guide for more information on how to get involved.
Development team¶
The core development team includes:
| GitHub handle | Full Name | |
|---|---|---|
| @tizianocitro | tcitro@unisa.it | Tiziano Citro |
| @ddevin96 | ddevinco@unisa.it | Daniele De Vinco |
Institutional partners¶

License¶
This project is under the MIT license. See LICENSE.