ugraph
Extend your graphs beyond structure—add meaning with ugraph.
ugraph builds on igraph to provide a powerful way to define and work with custom node and link types in your graphs. This package is ideal for those who need more than just graph structure—it empowers you to combine graph data with rich information via Python dataclasses, and comes with built-in support for JSON storage and 3D visualizations.
Because your graphs aren't just for you
(igraph → ugraph)
Why ugraph?
Graphs often represent more than their edges and nodes—they carry data, behaviors, and relationships that need to be understood in context. ugraph bridges this gap by enabling:
- Custom node and link classes: Add type-safe attributes and behaviors to your graph elements.
- Data serialization: Easily save and load your graphs in JSON format for persistence and sharing.
- 3D visualization: Render interactive, browser-based 3D visualizations in HTML using Plotly.
With ugraph, your graphs are as understandable and maintainable as the data they represent.
Features at a Glance
- Custom Classes: Define your nodes and links as Python dataclasses, allowing for type hints, IDE autocompletion, and type checking.
- Serialization: Store and reload your networks seamlessly using JSON files.
- Interactive Visualization: Generate 3D plots of your graphs in HTML for better insights and presentation.
Disclaimer
ugraph is not intended for creating graph figures or visualizations (e.g., bar charts, scatter plots). It is a tool for working with graph data structures (nodes and links) and enhancing their usability.
Installation
Install ugraph using pip:
pip install ugraph
(if you need igraph's cairo-based plotting, use pip install ugraph[cairo])
Quick Start
ugraph works similarly to igraph, with the added flexibility of custom node and link types. You can define attributes like coordinates, IDs, or any other domain-specific data in a type-safe and Pythonic way.
Explore usage examples in the examples directory, or start with a minimal example.
Documentation
For an extended introduction and code snippets, see docs/getting_started.md.
Credits
This project builds upon the excellent igraph library. We acknowledge and thank the igraph community for their foundational work.
License
See the LICENSE file for rights and limitations (MIT).
Metadata
Release files for ugraph 0.81.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ugraph-0.81.0.tar.gz | 15.7 kB | Without provenance | Details for ugraph-0.81.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ugraph-0.81.0-py3-none-any.whl | Python 3 | none | any | Details for ugraph-0.81.0-py3-none-any.whl |
Total release size: 34.0 kB
Release files / ugraph-0.81.0.tar.gz
| Download URL | ugraph-0.81.0.tar.gz |
|---|---|
| Size | 15.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9772b65ba125ecc58554a069d25e9a0d9918b0b69b49dfad4b1fed8b33c0c063
|
|
BLAKE2b-256 checksum How to use checksums |
ed2225f5f7b8a51f1e46a3f77f236e2af9b8facdd40a9b22a28d9d1448dfb260
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.13.5 Windows/11
|
Release files / ugraph-0.81.0-py3-none-any.whl
| Download URL | ugraph-0.81.0-py3-none-any.whl |
|---|---|
| Size | 18.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
42729b91e43d147df955f15ef0f9470b8b10622073cd35bef2ed4dd1272695b8
|
|
BLAKE2b-256 checksum How to use checksums |
b9202554c73d000325b79b700cfc404b49d7ff6a35871bd732a3423585d3ad0f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.13.5 Windows/11
|
Security for ugraph 0.81.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.