CLI Reference

Tablassert provides two commands for building knowledge graphs and validating configuration files.

build-knowledge-graph

Build A KGX Compliant Knowledge Graph From A Graph Configuration File

Synopsis

tablassert build-knowledge-graph <graph_configuration_file>

Options

Option Type Required Description
graph_configuration_file Path Yes Knowledge Graph Configuration -- See Docs

Example

tablassert build-knowledge-graph /path/to/MOKGV6.yaml

Description

This command runs the full extraction pipeline from a graph configuration file. It loads table configurations, downloads source files, applies transformations, resolves entities through dbssert, validates mappings with the QC pipeline (exact → fuzzy → BERT), and compiles subgraphs into KGX-compliant NDJSON files.

The process executes in parallel stages with rich progress bars showing: - Loading Tables - Extracting Sections - Building TCode - Collecting Instructions - Building Subgraphs - Compiling Graph

Final output files are written to the current working directory as: - {name}_{version}.nodes.ndjson - Node file (entities) - {name}_{version}.edges.ndjson - Edge file (relationships)

Intermediate parquet artifacts are written to storessert/ during section processing.

See Graph Configuration for details on the YAML schema.

verify-table-configuration-syntax

Verify The Syntax Of A Declarative Table Configuration File

Synopsis

tablassert verify-table-configuration-syntax <table_configuration_file>

Options

Option Type Required Description
table_configuration_file Path Yes Table Configuration -- See Docs

Example

tablassert verify-table-configuration-syntax /path/to/table-config.yaml

Description

This command validates a TC3 YAML configuration file without running the full extraction pipeline. It loads the file, extracts sections, and validates each section against the schema using Pydantic models. The command exits with a non-zero status if schema errors are detected, making it useful for CI/CD pipelines and pre-commit hooks.

Use this for: - Quick syntax validation during development - Pre-flight checks in CI/CD pipelines - Verifying configuration changes before running expensive graph builds

See Table Configuration for details on the YAML schema.

Examples

Build Knowledge Graph

tablassert build-knowledge-graph my-graph.yaml

Validate Table Configuration

tablassert verify-table-configuration-syntax table-config.yaml

Workflow

  1. Create table configuration - Define data sources and transformations
  2. Create graph configuration - Define output name, table configs, databases
  3. Validate table config - tablassert verify-table-configuration-syntax table.yaml
  4. Build knowledge graph - tablassert build-knowledge-graph graph.yaml
  5. Process executes:
  6. Downloads files from URLs (if needed)
  7. Applies transformations to each table
  8. Resolves entities using dbssert
  9. Validates mappings with QC pipeline
  10. Aggregates subgraphs into NDJSON

Next Steps