Registry / data / graphframes-py

graphframes-py

library0.12.2pypypi✓ verified 21d ago

GraphFrames is a powerful library for graph processing built on Apache Spark DataFrames. It allows users to perform graph analytics, queries, and algorithms like PageRank, connected components, and shortest paths directly using Spark's DataFrame API. The project is actively maintained, with frequent releases. The official Python package on PyPI is `graphframes-py`, and its latest version is 0.11.0.

data ai-ml

pip install graphframes-py

github ↗package ↗

INSTALL

IMPORT

SIG · GRAPHFRAMES-PY

graphframes-py

datapythonv0.12.2

Install

1.6s avg

Import

—

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.12.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 18.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.000s · 19MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GraphFrame

✓ from graphframes import GraphFrame

✗ from graphframes import GraphFrame

This quickstart demonstrates how to initialize a SparkSession with the GraphFrames package, create vertex and edge DataFrames, construct a GraphFrame, and run a PageRank algorithm. Ensure the `--packages` option uses the correct GraphFrames version for your Spark and Scala environment.

from pyspark.sql import SparkSession from pyspark.sql.functions import lit from graphframes import GraphFrame # Create a SparkSession with GraphFrames package # IMPORTANT: Replace '0.11.0-spark3.5-s_2.12' with the version compatible # with your Spark and Scala installation. Check GraphFrames docs for details. spark = SparkSession.builder \ .appName("GraphFrames Quickstart") \ .config("spark.jars.packages", "org.graphframes:graphframes:0.11.0-spark3.5-s_2.12") \ .getOrCreate() # Create a Vertex DataFrame v = spark.createDataFrame([ ("a", "Alice", 34), ("b", "Bob", 36), ("c", "Charlie", 30), ("d", "David", 29), ("e", "Esther", 32), ("f", "Fanny", 36) ], ["id", "name", "age"]) # Create an Edge DataFrame e = spark.createDataFrame([ ("a", "b", "friend"), ("b", "c", "follow"), ("c", "b", "follow"), ("f", "c", "follow"), ("e", "f", "follow"), ("e", "d", "friend"), ("d", "a", "friend") ], ["src", "dst", "relationship"]) # Create a GraphFrame g = GraphFrame(v, e) # Run PageRank algorithm results = g.pagerank(resetProbability=0.15, maxIter=5) results.vertices.select("id", "pagerank").show() spark.stop()

Debug

Known issues

breakingThe official PyPI package name for GraphFrames changed from `graphframes` to `graphframes-py` starting with v0.9.0. The old `graphframes` package on PyPI is severely outdated (v0.6) and should not be used.

fix

Always use `pip install graphframes-py`. Do not install `graphframes`.

affects: 0.9.0 and later

breakingThe Maven groupId for the GraphFrames JAR changed from `graphframes` to `io.graphframes` in v0.9.0. This affects how you specify the package with `--packages` in `spark-submit` or in `SparkSession` configurations.

fix

Update your Spark configurations to use `org.graphframes:graphframes:...` instead of `graphframes:graphframes:...`.

affects: 0.9.0 and later

gotchaGraphFrames is a Spark library and requires a running Spark cluster. Installing the Python package (`graphframes-py`) is not enough; you must also provide the GraphFrames JAR to your Spark runtime. This is typically done via `spark-submit --packages` or `SparkSession.builder.config("spark.jars.packages", ...)`.

fix

Ensure your Spark environment is configured to include the GraphFrames JAR. Refer to the 'install' and 'quickstart' examples for correct setup.

affects: All versions

gotchaGraphFrames has strict compatibility requirements with specific versions of Spark and Scala. Using an incompatible GraphFrames JAR version with your Spark distribution will lead to runtime errors.

fix

Always check the official GraphFrames documentation for the correct JAR artifact name (e.g., `org.graphframes:graphframes:0.11.0-spark3.5-s_2.12`) that matches your Spark and Scala versions.

affects: All versions

breakingSignificant API updates occurred in v0.9.0, including changes to the Pregel API and internal implementations of algorithms like Connected Components (CC), Community Detection using Label Propagation (CDLP), and Shortest Paths (SP). Some GraphX-free implementations were introduced.

fix

Review the official GraphFrames documentation for v0.9.0+ when upgrading from older versions, especially if using advanced algorithms or custom Pregel implementations.

affects: 0.9.0 and later

Upgrade

Version history

0.12.2latest on PyPI · released Aug 28, 2026

Audit

Dependencies

pysparkrequiredGraphFrames is built on Apache Spark DataFrames, requiring PySpark for Python API interaction.

org.graphframes:graphframes:0.11.0-spark3.5-s_2.12requiredThe core GraphFrames library is a Scala/Java JAR which must be provided to the Spark runtime. The version must match your Spark and Scala versions.

Agent activity

14 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/graphframes/graphframes ↗

packagehttps://pypi.org/project/graphframes-py/ ↗