Graphinate. Data to Graphs.
| Package |
|
| Code |
|
| Tools |
|
| CI/CD |
|
| Scans |
|
| Mentions |
|
| Badge |
|
Table of Contents
Introduction
Meet Graphinate
Graphinate turns your data into Graphs. Effortlessly.
It is a Python library designed to streamline the pipeline from raw data to structured Graph representations. With Graphinate, you can easily map complex data hierarchies and payloads directly to nodes and edges, creating an efficient retrieval system.
Whether you need to visualize relationships, analyze structure, or serve data via an API, Graphinate provides the tools to bring your graph to life.
Graphinate uses and builds upon the excellent NetworkX.
Library at a Glance
📐 The Architect (graphinate.modeling)
Define the blueprint of your graph by decorating simple functions that yield your data as nodes and edges.
🏗️ The Construction Crew (graphinate.builders)
Takes your graph blueprint and constructs various outputs, whether it's a queryable NetworkX object, a Mermaid diagram, or a GraphQL schema.
🎨 The Artists (graphinate.renderers)
A suite of tools to visualize your graphs, from matplotlib plots to interactive Mermaid diagrams.
📡 The Broadcaster (graphinate.server)
Instantly serve your graph data as an interactive GraphQL API, ready for consumption by web applications.
⌨️ The Command Center (graphinate.cli)
A handy command-line tool to manage and interact with your graph definitions without writing boilerplate code.
Links
- Website (including documentation): https://erivlis.github.io/graphinate
- Source: https://github.com/erivlis/graphinate
- Package: https://pypi.org/project/graphinate
Quick Start
Install
Graphinate is available on PyPI:
pip install graphinate
or
uv add graphinate
To install with server support
pip install graphinate[server]
or
uv add graphinate[server]
Graphinate officially supports Python >= 3.10.
Example
import graphinate
N: int = 8
# First Define a GraphModel instance.
# It will be used to hold the graph definitions
graph_model: graphinate.GraphModel = graphinate.model(name="Octagonal Graph")
# Register in the Graph Model the edges' supplier generator function
@graph_model.edge()
def edge():
for i in range(N):
yield {'source': i, 'target': i + 1}
yield {'source': N, 'target': 0}
# Use the NetworkX Builder
builder = graphinate.builders.NetworkxBuilder(graph_model)
# build the NetworkX GraphRepresentation
# the output in this case is a nx.Graph instance
graph = builder.build()
# this supplied plot method uses matplotlib to display the graph
graphinate.matplotlib.plot(graph, with_edge_labels=True)
# or use the Mermaid Builder
builder = graphinate.builders.MermaidBuilder(graph_model)
# to create a Mermaid diagram
diagram: str = builder.build()
# and get Markdown or single page HTML to display it
mermaid_markdown: str = graphinate.mermaid.markdown(diagram)
mermaid_html: str = graphinate.mermaid.html(diagram, title=graph_model.name)
# or use the GraphQL Builder
builder = graphinate.builders.GraphQLBuilder(.graph_model)
# to create a Strawberry GraphQL schema
schema = builder.build()
# and serve it using Uvicorn web server
graphinate.graphql.server(schema)
CLI
For detailed information on the command-line interface, please see the CLI Usage Guide in the official documentation.
Gallery
Python Class AST
matplotlib
3D Force-Directed Animation
GitHub Repository
Web Links
Development
For instructions on how to set up your development environment, run tests, and contribute to the project, please see the Development Guide in the official documentation.
Acknowledgements
For a list of the dependencies and tools that make Graphinate possible, please see the Acknowledgements page in the official documentation.
Copyright © 2023-2026 Eran Rivlis
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file graphinate-0.15.0.tar.gz.
File metadata
- Download URL: graphinate-0.15.0.tar.gz
- Upload date:
- Size: 2.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ea8ffd48eb2f8c43f2a7a1abc9d7eb7ea1db7b72dc5ac3c85a02d48e9d9fad5c
|
|
| MD5 |
9b32862675c7ee9d3a2bcbc4bb4e72bb
|
|
| BLAKE2b-256 |
387e93395864bd14986ff1d324da12eeb173c64ccac1e1fb951806e7a0570484
|
File details
Details for the file graphinate-0.15.0-py3-none-any.whl.
File metadata
- Download URL: graphinate-0.15.0-py3-none-any.whl
- Upload date:
- Size: 121.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fb6c41ae0b042b280eb01554bf6d53d34feb88b3878faea33be311f48e94302c
|
|
| MD5 |
d9324ac8e2e7de7b5a779e24f1f5ad99
|
|
| BLAKE2b-256 |
e7932b8c3ac005f7d279d28c9bc797afeaf584a8162aceb27de9692876a4a12e
|
