Skip to main content

ugraph

PyPI version Downloads black isort License: MIT mypyc flake8 pylint

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)

Source distribution for ugraph 0.81.0
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)

Table of built distributions (wheels) for ugraph 0.81.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.81.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page