glyf

Tests Coverage Python 3.11+ Rust 1.83+ License

Open Source Visualization build tool to data pipeline.

glyf turns analytical metadata and SQL-first visualisation files into versioned chart artifacts and static dashboards. Its first integration reads dbt project artifacts, resolves dbt ref() and source() calls from target/manifest.json, executes chart SQL with DuckDB, renders PNG/SVG charts with Altair, and exports publishable dashboard sites.

glyf is artifact-driven, not dbt-runtime-driven. Run dbt first, then run glyf against the resulting artifacts and relations.

Installation

Install from a GitHub Release wheel:

uv tool install \
  https://github.com/glyf-data/glyf/releases/download/v0.2.0/glyf-0.2.0-<platform>.whl

Replace <platform> with the wheel asset that matches your OS and architecture.

PyPI publishing is intentionally deferred for now.

When developing from this repository, install dependencies with uv:

uv sync

For the included dbt examples, dev dependencies include dbt-core and dbt-duckdb.

CI Run

This project uses Taskfile to run the same checks locally and in GitHub Actions. Install Task before running these commands:

brew install go-task
task --version

Run the full CI pipeline:

task ci

Run CI with a specific Python version:

task ci PYTHON_VERSION=3.12

Run individual CI steps:

task install
task test
task coverage
task build
task dashboard-ci

task test runs pytest with coverage and writes coverage.xml; CI uploads that report to Codecov for the README coverage badge.

Copy-Paste Quickstart

In a dbt project:

glyf init
dbt build
glyf doctor
glyf build
glyf serve

For the included example project:

uv sync
cd examples/simple_dbt
uv run dbt seed --profiles-dir . --full-refresh --no-partial-parse
uv run dbt run --profiles-dir .
uv run dbt compile --profiles-dir .
uv run glyf build
uv run glyf serve

This creates the example DuckDB database at examples/simple_dbt/target/simple_dbt.duckdb.

Open:

examples/simple_dbt/target/glyf/site/index.html

CLI

High-level workflow commands:

uv run glyf init
uv run glyf doctor
uv run glyf build
uv run glyf serve

Low-level control commands:

uv run glyf list
uv run glyf validate
uv run glyf render
uv run glyf dashboard
uv run glyf export --clean --zip

Point at another project:

uv run glyf build --project-dir examples/sales_dashboard

Preview a generated dashboard locally:

uv run glyf build --project-dir examples/simple_dbt
uv run glyf serve --project-dir examples/simple_dbt
uv run glyf serve --project-dir examples/simple_dbt --host 127.0.0.1 --port 8080

Example Output

Generated files are written under target/glyf/:

target/glyf/
  compiled/
  charts/
  dashboards/
  site/
  index.html

The publish-ready site lives in:

target/glyf/site/

Examples

See examples/README.md.

  • examples/simple_dbt
  • examples/sales_dashboard
  • examples/product_analytics
  • examples/finance_metrics

Documentation

The Docusaurus docs site source lives in docs-site. It is intended to be the primary documentation experience with a landing page, quickstart, examples gallery, command reference, integrations, AI context, and community resources.

Run it locally after installing Node.js:

cd docs-site
npm install
npm start

Existing Markdown docs are still available while the site is being introduced:

Roadmap

See ROADMAP.md for the detailed future roadmap.

Near-term themes:

  • richer chart syntax while keeping the parser small
  • more dashboard layouts
  • better error messages for dbt adapter-specific execution failures
  • snapshot tests for generated HTML
  • optional publish helpers for common static hosts
  • local serve and watch workflows after the release baseline is stable

Project links

Data verified by PyPI on Aug 26, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.6.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kannandreams from gravatar.com kannandreams

Credits

Author: Kannan Kalidasan

GitHub Statistics

Data verified by PyPI on Aug 26, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.11

Tags

visualization dashboards charts analytics semantic-layer static-site dbt

Classifiers

Report project as malware

Download files

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

Source Distribution

glyf_core-0.3.0.tar.gz (206.7 kB view details)

Uploaded Source

Built Distributions

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

glyf_core-0.3.0-cp311-abi3-win_amd64.whl (3.8 MB view details)

Uploaded CPython 3.11+Windows x86-64

glyf_core-0.3.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.4 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.17+ x86-64

glyf_core-0.3.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (4.3 MB view details)

Uploaded CPython 3.11+manylinux: glibc 2.17+ ARM64

glyf_core-0.3.0-cp311-abi3-macosx_11_0_arm64.whl (3.7 MB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

glyf_core-0.3.0-cp311-abi3-macosx_10_12_x86_64.whl (4.0 MB view details)

Uploaded CPython 3.11+macOS 10.12+ x86-64

File details

Details for the file glyf_core-0.3.0.tar.gz.

File metadata

  • Download URL: glyf_core-0.3.0.tar.gz
  • Upload date:
  • Size: 206.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for glyf_core-0.3.0.tar.gz
Algorithm Hash digest
SHA256 8b7b52822b075c1673759bca4e1a2964cfc070fbb5d6d625896d144cecb32e53
MD5 c673e9fab6a025c4d2f0311dfa3d087f
BLAKE2b-256 c07e344a7246ae017b0bbec07aa7bcbe33b70830b466dd837f293d414612d554

See more details on using hashes here.

Provenance

The following attestation bundles were made for glyf_core-0.3.0.tar.gz:

Publisher: release.yml on glyf-data/glyf

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

File details

Details for the file glyf_core-0.3.0-cp311-abi3-win_amd64.whl.

File metadata

  • Download URL: glyf_core-0.3.0-cp311-abi3-win_amd64.whl
  • Upload date:
  • Size: 3.8 MB
  • Tags: CPython 3.11+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for glyf_core-0.3.0-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 ef7128c4142e739be5b9f18226f6cfb34f638a1a8442aa72a5db490013758dbe
MD5 566b288a8286cbc12301965af15164cf
BLAKE2b-256 606648fd1f619c54996acfd780f2f53363c2a8df762af334a94defbe6a9f74b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for glyf_core-0.3.0-cp311-abi3-win_amd64.whl:

Publisher: release.yml on glyf-data/glyf

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

File details

Details for the file glyf_core-0.3.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for glyf_core-0.3.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 f120f60999751904ba2274df695f61c393ac2a571ee6d4e72d550451ea7b4c4c
MD5 3a1c2b50bbffe738d4011944bfb39cdc
BLAKE2b-256 131554819288764cac6487545e8f31aa8f90cd919a3ed502734530d86f77d56c

See more details on using hashes here.

Provenance

The following attestation bundles were made for glyf_core-0.3.0-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on glyf-data/glyf

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

File details

Details for the file glyf_core-0.3.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for glyf_core-0.3.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 c8e61cdb17cf037167981d59b4e7dbe354ee07a39d5053ac3e182d6d4843fc35
MD5 271e824ae79ea9a9b3c8985b6e7c0e01
BLAKE2b-256 65f0384081908f44485e1d2c3cd6520762afd8e78cb205ca4724b361e2840918

See more details on using hashes here.

Provenance

The following attestation bundles were made for glyf_core-0.3.0-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on glyf-data/glyf

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

File details

Details for the file glyf_core-0.3.0-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for glyf_core-0.3.0-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 91b678232ef76bbb2448a3375b05ade9981bb0fcb1c57ab857aa64abdb4b4f36
MD5 8167f2a3148dc74d0526fd82d7eda8c0
BLAKE2b-256 dedd407e442649e237db1939b1f3f16d0099c3fed14ba6f4c38895152d58cb1f

See more details on using hashes here.

Provenance

The following attestation bundles were made for glyf_core-0.3.0-cp311-abi3-macosx_11_0_arm64.whl:

Publisher: release.yml on glyf-data/glyf

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

File details

Details for the file glyf_core-0.3.0-cp311-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for glyf_core-0.3.0-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 c892313bebaaa21d900a3b638d6cff5599ac9f18479338fbb4ea2a20d7e261fb
MD5 f8733b721da1beff03afd8e6d943f06c
BLAKE2b-256 a1c42ec8a8fde56d08ad0b00096a99faa543b6b6358bd1c1ec05e69c157a6085

See more details on using hashes here.

Provenance

The following attestation bundles were made for glyf_core-0.3.0-cp311-abi3-macosx_10_12_x86_64.whl:

Publisher: release.yml on glyf-data/glyf

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

Release history Release notifications | RSS feed

0.6.0

6 files

0.5.0

6 files

0.4.0

6 files

This release

0.3.0 This release

6 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page