ultipa 6.2.8

Pure Python Ultipa Driver

Ultipa Python Driver

Official Python driver for Ultipa graph database (GQL).

Requirements

• Python 3.10+

Installation

pip install ultipa          # base driver
pip install ultipa[ml]      # + graph ML data loaders (torch); see gqldb.ml

Note: This is the v6.x driver for Ultipa Graph. If you are using Ultipa v4.x, please install ultipa==4.5.2. If you are using Ultipa v5.x, please install ultipa==5.2.1.

Quick Start

from gqldb import GqldbClient
from gqldb.config import GqldbConfig

# Create client
config = GqldbConfig(
    hosts=["localhost:60061"],
    username="admin",
    password="password",
    default_graph="myGraph"
)
client = GqldbClient(config)
client.login("admin", "password")

# Execute query
response = client.gql("MATCH (n) RETURN n LIMIT 10")

print(f"Rows: {len(response.rows)}")
print(f"Columns: {response.columns}")

# Close
client.close()

Features

• GQL query execution with parameters
• Streaming results for large datasets
• Transaction support (begin, commit, rollback)
• Graph management (create, drop, list)
• Bulk import for high-throughput loading
• Algorithm support (CALL algo.pagerank, algo.degree, etc.)
• Graph ML data loaders for PyTorch Geometric / DGL — gqldb.ml (GraphLoader, NeighborLoader, EdgeLoader)
• Type hints support
• Health checks

Documentation

See Quick Start for detailed usage.

For the graph ML data loaders (streaming features / subgraphs into PyTorch Geometric / DGL for GNN training), see gqldb/ml/README.md.

License

MIT License