VitalGraph

VitalGraph is a high-performance knowledge graph database and client library built on PostgreSQL with full SPARQL 1.1 support.

Installation

VitalGraph offers flexible installation options depending on your use case:

Client Only (Default - Lightweight)

For applications that only need to connect to existing VitalGraph servers:

pip install vital-graph[client]

This installs dependencies for the VitalGraph client library:

Basic RDF processing (rdflib, PyLD)
Advanced graph processing (pyoxigraph)
AI capabilities (openai)
HTTP client (httpx, aiohttp)
Configuration management (PyYAML, pydantic)
CLI tools (click-repl, tabulate)

Server Installation

For running a complete VitalGraph server with database capabilities:

pip install vital-graph[server]

This includes all server dependencies:

FastAPI web framework and uvicorn server
PostgreSQL drivers (psycopg, asyncpg)
Database ORM (SQLAlchemy, alembic)
Vector database support (pgvector)
Authentication (PyJWT, email-validator)
ML/vectorization (torch, transformers, sentencepiece)
Fuzzy search (rapidfuzz, jellyfish, datasketch)

Development Setup

For development with all tools:

pip install vital-graph[dev]

Includes pytest, black, mypy, and other development tools.

Full Installation

For everything:

pip install vital-graph[all]

Custom Combinations

You can combine multiple extras:

pip install vital-graph[client,dev]
pip install vital-graph[server,test,docs]

Quick Start

Client Usage

from vitalgraph.client import VitalGraphClient

# Initialize client with config file
client = VitalGraphClient("path/to/config.yaml")

# Connect to server
await client.open()

# Execute SPARQL queries
results = await client.sparql.query("SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10")

# Close connection
await client.close()

Server Usage

# Start VitalGraph server
vitalgraphdb

# Or with custom config
vitalgraphdb --config /path/to/vitalgraphdb-config.yaml

Data Import/Export

# Import RDF data (N-Triples, N-Quads, Turtle, JSONL, VitalSigns Block)
vitalgraphimport -s my_space -f data.nt
vitalgraphimport -s my_space -f entities.vital --format vital

# Export RDF data
vitalgraphexport -s my_space -f backup.nq
vitalgraphexport -s my_space -f entities.vital --format vital --entity-type-uri urn:PersonEntity

# See all options
vitalgraphimport --help
vitalgraphexport --help

Import/export is also available via the REST API (/api/data/import, /api/data/export) and the frontend Data Management page.

Features

Full SPARQL 1.1 Support: SELECT, CONSTRUCT, ASK, DESCRIBE, UPDATE operations
High Performance: PostgreSQL-backed with optimized query translation
RESTful API: Complete REST API for all operations
Client Library: Python client with authentication and session management
Docker Support: Ready-to-use Docker containers
Knowledge Graph Types: Built-in support for VitalSigns ontologies
Real-time Updates: WebSocket support for live data updates

Architecture

VitalGraph consists of:

Client Library (vitalgraph.client): Lightweight REST API client
Server (vitalgraph.api): FastAPI-based graph database server
SPARQL-to-SQL Engine (vitalgraph.db.sparql_sql): Translates SPARQL 1.1 to PostgreSQL
Jena Sidecar (vitalgraph-jena-sidecar): Java service for SPARQL algebra compilation
React Admin UI (frontend): Web interface for space/graph/entity management
Admin Tools (vitalgraphadmin): Database administration utilities
Import/Export CLIs (vitalgraphimport, vitalgraphexport): Standalone data import/export tools
TypeScript Client (vitalgraph-client-ts): TypeScript/JS client SDK

Documentation

License

Apache License 2.0

Metadata

Release files for vital-graph 0.0.46

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vital-graph 0.0.46
File	Size	Uploaded
vital_graph-0.0.46.tar.gz	8.1 MB	Oct 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for vital-graph 0.0.46
File	Interpreter	ABI	Platform	Reset
vital_graph-0.0.46-py3-none-any.whl 8.5 MB Oct 4, 2026	Python 3	none	any	Details

Total release size: 16.6 MB

Release files / vital_graph-0.0.46.tar.gz

Download URL	vital_graph-0.0.46.tar.gz
Size	8.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`a01908364fe39017226eb2b47c6b13faaed39bfb55e88532df8a9fe0371a6b2d`
BLAKE2b-256 checksum How to use checksums	`6201483c5aa523ed31a71cd02b04b148ec6320cde915da972ab2583aef1faf14`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.11`

Release files / vital_graph-0.0.46-py3-none-any.whl

Download URL	vital_graph-0.0.46-py3-none-any.whl
Size	8.5 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`5435f47a6dfaa6aff0d739de39df8c0b0a080b98dca1302a6aec38aa304c8d42`
BLAKE2b-256 checksum How to use checksums	`8c1c4e78e54dea7ed3e109a3b83cf838b55bcc32a0505f7ac896fdb8f3d7dcc8`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.11`