Metadata-Version: 2.4
Name: pystardog
Version: 0.19.0
Summary: Python client for Stardog Platform Endpoints and Stardog Cloud
Author-email: Stardog Union <support@stardog.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/stardog-union/pystardog
Project-URL: Repository, https://github.com/stardog-union/pystardog
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: requests-toolbelt>=1.0.0
Requires-Dist: contextlib2>=0.5.5
Requires-Dist: rdflib>=6.0.0
Provides-Extra: cloud
Requires-Dist: httpx>=0.24.0; extra == "cloud"
Requires-Dist: pydantic>=2.0.0; extra == "cloud"
Provides-Extra: dev
Requires-Dist: pytest==8.4.1; extra == "dev"
Requires-Dist: pytest-asyncio==1.1.0; extra == "dev"
Requires-Dist: pytest-cov==6.2.1; extra == "dev"
Requires-Dist: black==22.3.0; extra == "dev"
Requires-Dist: requests-mock==1.10.0; extra == "dev"
Requires-Dist: respx==0.22.0; extra == "dev"
Requires-Dist: flake8==7.1.1; extra == "dev"
Requires-Dist: tox==4.2.6; extra == "dev"
Provides-Extra: docs
Requires-Dist: Sphinx==6.2.1; extra == "docs"
Requires-Dist: sphinx-rtd-theme==3.0.2; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints==1.23.0; extra == "docs"
Requires-Dist: sphinx-autobuild==2021.3.14; extra == "docs"
Requires-Dist: recommonmark==0.5.0; extra == "docs"
Requires-Dist: autodoc_pydantic>=2.0.0; extra == "docs"
Provides-Extra: build
Requires-Dist: build>=1.0.0; extra == "build"
Requires-Dist: twine>=6.1.0; extra == "build"
Dynamic: license-file

# pystardog
[![PyPI version](https://badge.fury.io/py/pystardog.svg)](https://badge.fury.io/py/pystardog)

Python client for Stardog servers and Stardog Cloud.

**Requirements**: Python 3.9+

## Quick Start

Install from PyPI:

```shell
pip install pystardog
```

For Stardog Cloud functionality:

```shell
pip install pystardog[cloud]
```

## Documentation

**Full documentation**: [http://pystardog.readthedocs.io](http://pystardog.readthedocs.io)

- [**Getting Started**](http://pystardog.readthedocs.io/en/latest/getting-started.html) - Installation, examples, and basic usage
- [**API Reference**](http://pystardog.readthedocs.io/en/latest/source/stardog.html) - Complete API documentation  
- [**Contributing**](http://pystardog.readthedocs.io/en/latest/contributing.html) - Development setup, testing, and contribution guidelines

## Interactive Tutorial

There is a Jupyter notebook and instructions in the [`notebooks`](./notebooks) directory of this repository.

## Voicebox Demo

Interactive example showing natural language queries with Stardog Cloud's Voicebox ([`examples/voicebox_example.py`](examples/voicebox_example.py)):

![Voicebox Demo](examples/voicebox_demo.gif)

