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.50.tar.gz (192.8 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.50-py3-none-any.whl (241.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qlever-0.5.50.tar.gz
  • Upload date:
  • Size: 192.8 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.50.tar.gz
Algorithm Hash digest
SHA256 b2311f816b9de2cc6c9f22e7b0377bcf706c20b117720562ddba7628e0381288
MD5 979e946a71213d1c4fddc10044fd4bb1
BLAKE2b-256 6f02fc596573397e0ed730dab9dbc2dfbadeeaa4cde2369d0d95f784bbce239e

See more details on using hashes here.

Provenance

The following attestation bundles were made for qlever-0.5.50.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.50-py3-none-any.whl.

File metadata

  • Download URL: qlever-0.5.50-py3-none-any.whl
  • Upload date:
  • Size: 241.1 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.50-py3-none-any.whl
Algorithm Hash digest
SHA256 86ee2bba9e42d9fef016a644c4310b2de91bdfc0d581a58de5503ca97ce25072
MD5 e4651db40a2846daa9528827dc0af848
BLAKE2b-256 e74d1238f5ece5def2fce9234f13ce8aa30b00cd366ad13346eaede60ed13cd5

See more details on using hashes here.

Provenance

The following attestation bundles were made for qlever-0.5.50-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