Skip to content

topic

The topic command group provides tools for inspecting and managing topic structures after generation. These commands work with both tree (JSONL) and graph (JSON) formats.

Subcommands

  • topic inspect

    Explore topic structure, browse levels, and discover node UUIDs

    Reference

  • topic prune

    Remove branches or depth levels from topic graphs

    Reference

Workflow

Topic management fits naturally into the generation workflow:

Generate, inspect, and refine
# 1. Generate topic structure
deepfabric generate config.yaml --topic-only

# 2. Inspect the result
deepfabric topic inspect topics.json --level 1 --expand

# 3. Prune if needed (preview first)
deepfabric topic prune topics.json --level 2 --dry-run
deepfabric topic prune topics.json --level 2 -o refined_topics.json

# 4. Verify the pruned structure
deepfabric topic inspect refined_topics.json --all

# 5. Generate dataset from refined topics
deepfabric generate config.yaml --topics-load refined_topics.json

Iterative Refinement

Use inspect and prune iteratively to shape your topic structure before committing to dataset generation. This avoids wasting API calls on unwanted branches.