# 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)

