Skip to main content

QLever

This repository provides a self-documenting and easy-to-use command-line tool for QLever (pronounced "Clever"), a graph database implementing the RDF and SPARQL standards. For a detailed description of what QLever is and what it can do, see here.

Documentation

View the latest documentation at https://docs.qlever.dev/quickstart.

Installation

There are native packages available for

On other platforms simply install the qlever command-line python package using pipx/uv. Note: QLever will be executed in a container which will come with a performance penalty.

Use with your own dataset

To use QLever with your own dataset, you need a Qleverfile, like in the example above. The easiest way to write a Qleverfile is to get one of the existing ones (using qlever setup-config ...) and then change it according to your needs. Pick one for a dataset that is similar to yours and when in doubt, pick olympics. A reference of all options is available.

For developers

The (Python) code for the script is in the *.py files in src/qlever. The preconfigured Qleverfiles are in src/qlever/Qleverfiles.

If you want to make changes to the script, or add new commands, do as follows:

git clone https://github.com/ad-freiburg/qlever-control
cd qlever-control
pip install -e ".[dev]"
# To also render index resource-usage plots, add the "plot" extra:
# pip install -e ".[dev,plot]"

Then you can use qlever just as if you had installed it via pip install qlever. Note that you don't have to rerun pip install -e ".[dev]" when you modify any of the *.py files and not even when you add new commands in src/qlever/commands. The executable created by pip simply links and refers to the files in your working copy.

If you have bug fixes or new useful features or commands, please open a pull request. If you have questions or suggestions, please open an issue. Files have to be formatted and linted with ruff:

# manually
ruff format
ruff check
# runs automatically before every commit
pre-commit install

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qlever-0.5.49.tar.gz (192.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qlever-0.5.49-py3-none-any.whl (240.9 kB view details)

Uploaded Python 3

File details

Details for the file qlever-0.5.49.tar.gz.

File metadata

  • Download URL: qlever-0.5.49.tar.gz
  • Upload date:
  • Size: 192.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for qlever-0.5.49.tar.gz
Algorithm Hash digest
SHA256 df99f3fa52bb977b84fd3696459104f09a898abdab3e6a3ed327998b6ff5cc51
MD5 cc5e90e0be4ff239d4cfe8c1de3c26bd
BLAKE2b-256 d653813f2bab2c03c54d75e69f6c6c9539fac22be20082b4db30f9acad96d997

See more details on using hashes here.

Provenance

The following attestation bundles were made for qlever-0.5.49.tar.gz:

Publisher: publish-pypi.yml on qlever-dev/qlever-control

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qlever-0.5.49-py3-none-any.whl.

File metadata

  • Download URL: qlever-0.5.49-py3-none-any.whl
  • Upload date:
  • Size: 240.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for qlever-0.5.49-py3-none-any.whl
Algorithm Hash digest
SHA256 096bb5156f473eccec07297fe6e59cc0c98fdb9855f20c3909de538afe6c0a2f
MD5 c62324912f394900f1167bef4b9cd34d
BLAKE2b-256 13cfae64bbce16ce45120889cd63c6b8f255191ac506762bc6018b2c82c95630

See more details on using hashes here.

Provenance

The following attestation bundles were made for qlever-0.5.49-py3-none-any.whl:

Publisher: publish-pypi.yml on qlever-dev/qlever-control

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page