Working with Context Cores Using CLI

Description

Use command-line tools to create, download, upload, and load knowledge cores

Difficulty

Advanced

Duration

15 min

You will need
  • TrustGraph instance running
  • Familiarity with knowledge cores concepts
Goal

Use CLI tools to create, download, upload, and load knowledge cores for sharing and managing extracted knowledge.

This guide covers the same knowledge core workflow as the Working with Context Cores guide, but using command-line tools instead of the Workbench.

New to knowledge cores? Read the Working with Context Cores guide first to understand what cores are and their lifecycle (offline → online → loaded).

This guide demonstrates:

  • Creating flows with core extraction enabled
  • Downloading cores via CLI
  • Uploading cores to other instances
  • Loading cores into retrieval stores

Step-by-Step Guide

Step 1: Load Your Document

Download and load the example document:

wget -O README.cats https://raw.githubusercontent.com/trustgraph-ai/example-data/refs/heads/main/cats/README.cats

tg-add-library-document \
  --name "README.cats" \
  --description "Brief description of cats" \
  --tags cats,animals \
  --id https://trustgraph.ai/doc/readme-cats \
  --kind text/plain \
  README.cats

Step 2: Create a Collection

Create a collection:

tg-set-collection -n Cats -d 'Cat information' cats

Step 3: Create the Flow

Create a flow with the kg-store processor for core creation:

tg-start-flow -n document-rag+graph-rag+kgcore -i core-building -d "Core building"

Step 4: Submit the Document for Processing

Submit the document for processing:

tg-start-library-processing \
    --flow-id core-building \
    --document-id https://trustgraph.ai/doc/readme-cats \
    --collection cats \
    --processing-id urn:processing-03

Step 5: Monitoring (Optional)

Processing can take time. For monitoring details, see the Working with Context Cores guide monitoring section.

Step 6: View the Knowledge Core

List available cores:

tg-show-kg-cores

Output:

https://trustgraph.ai/doc/readme-cats

Step 7: Download the Knowledge Core

Download the core as a file:

tg-get-kg-core \
  --id https://trustgraph.ai/doc/readme-cats \
  --output readme-cats.core

Output:

Got: 2 triple, 1 GE messages.

Verify the download:

ls -lh readme-cats.core

Step 8: Upload the Knowledge Core

Upload the core to another TrustGraph instance (or the same one with a different ID):

tg-put-kg-core \
  --id https://trustgraph.ai/doc/cats-copy \
  --input readme-cats.core

Output:

Put: 2 triple, 1 GE messages.

Step 9: Load the Knowledge Core for Retrieval

Create a new collection and load the core into it:

tg-set-collection \
  -n "Cats Copy" \
  -d "Loaded from knowledge core" \
  cats-copy

tg-load-kg-core \
  --id https://trustgraph.ai/doc/cats-copy \
  --collection cats-copy

The command will report progress as it loads the core:

Loading core into retrieval stores...
Loaded: 2 triple batches, 1 GE batches.

Verify the core is loaded by performing a GraphRAG query:

tg-invoke-graph-rag \
  -q "What do you know about cats?" \
  -C cats-copy

You should receive a response based on the knowledge extracted from the README.cats document.

Note: The core is now “loaded” - the knowledge is available in retrieval stores and can be queried using GraphRAG operations.

Next Steps