CausalIQ Knowledge CLI¶
The command-line interface provides a quick way to test LLM queries about causal relationships.
Installation¶
The CLI is automatically installed when you install the package:
Usage¶
Basic Query¶
# Query using default model (Groq)
cqknow query smoking lung_cancer
# With domain context
cqknow query smoking lung_cancer --domain medicine
Multiple Models¶
# Query multiple models for consensus
cqknow query X Y --model groq/llama-3.1-8b-instant --model gemini/gemini-2.5-flash
JSON Output¶
Options¶
| Option | Short | Description |
|---|---|---|
--model |
-m |
LLM model to query (can be repeated) |
--domain |
-d |
Domain context (e.g., "medicine") |
--strategy |
-s |
Consensus strategy: weighted_vote or highest_confidence |
--json |
Output as JSON | |
--temperature |
-t |
LLM temperature (0.0-1.0) |
Cache Management¶
The cache command group provides tools for inspecting and managing the LLM response cache.
Cache Stats¶
View statistics about a cache database:
# Show cache statistics
cqknow cache stats ./llm_cache.db
# Output:
# Cache: ./llm_cache.db
# ========================================
# Entries: 42
# Tokens: 15,230
Cache Export¶
Export cache entries to human-readable JSON files:
# Export all entries to a directory
cqknow cache export ./llm_cache.db ./export_dir
# Export to a zip archive (auto-detected from .zip extension)
cqknow cache export ./llm_cache.db ./export.zip
Files are named using the format {id}_{timestamp}_{provider}.json:
JSON Output¶
# Get stats as JSON for scripting
cqknow cache stats ./llm_cache.db --json
# Get export result as JSON
cqknow cache export ./llm_cache.db ./export_dir --json
Cache Command Options¶
| Command | Description |
|---|---|
cache stats <path> |
Show entry and token counts |
cache stats <path> --json |
Output stats as JSON |
cache export <path> <dir> |
Export entries to directory |
cache export <path> <file.zip> |
Export entries to zip archive |
cache export <path> <output> --json |
Output export result as JSON |
cache import <cache> <input> |
Import entries from directory or zip |
cache import <cache> <input> --json |
Output import result as JSON |
Cache Import¶
Import cache entries from JSON files:
# Import from a directory
cqknow cache import ./llm_cache.db ./import_dir
# Import from a zip archive (auto-detected from .zip extension)
cqknow cache import ./llm_cache.db ./export.zip
# Get import result as JSON
cqknow cache import ./llm_cache.db ./import_dir --json
Entry types are auto-detected from JSON structure:
- LLM entries: JSON containing cache_key.model, cache_key.messages, and response
- Generic JSON: Any other valid JSON file
This enables round-trip operations: export from one cache, import into another.
Graph Generation¶
The generate command group provides tools for generating causal graphs from
network context files using LLMs.
Generate Graph¶
Generate a complete causal graph from a network context file:
# Basic usage with default settings
cqknow generate graph -n context.json
# Use a specific LLM and request ID
cqknow generate graph -n context.json -m gemini/gemini-2.5-flash --id expt01
# Use rich context level
cqknow generate graph -n context.json --prompt-detail rich
# Save output to file
cqknow generate graph -n context.json -o output.json
Generate Command Options¶
| Option | Short | Description |
|---|---|---|
--network-context |
-n |
Path to network context JSON file (required) |
--prompt-detail |
-p |
Context level: minimal, standard, or rich |
--llm |
-m |
LLM model to use |
--output |
-o |
Output file path (JSON) |
--format |
-f |
Output format: edge_list or adjacency_matrix |
--json |
Output result as JSON to stdout | |
--id |
Request identifier for export filenames (default: cli) | |
--use-benchmark-names |
Use benchmark names instead of LLM names | |
--cache/--no-cache |
Enable/disable response caching | |
--cache-path |
-c |
Path to cache database |
--temperature |
-t |
LLM temperature (0.0-1.0) |
The --id option sets a request identifier that is stored in the cache
metadata (not affecting cache key matching). This identifier is used in export
filenames with the format {id}_{timestamp}_{provider}.json.
CLI Entry Point¶
Command-line interface for causaliq-knowledge.
This package provides the CLI implementation split into logical modules:
- main: Core CLI entry point
- cache: Cache management commands (stats, export, import)
- generate: Graph generation commands
- models: Model listing command
Modules:
-
cache–Cache management CLI commands.
-
generate–Graph generation CLI commands.
-
main–Main CLI entry point and core commands.
-
models–Model listing CLI command.
Functions:
-
cli–CausalIQ Knowledge - LLM knowledge for causal discovery.
CausalIQ Knowledge - LLM knowledge for causal discovery.
Use 'cqknow generate_graph' to generate causal graphs. Use 'cqknow list_models' to list available LLM models.
LLM Cache Management (for caching LLM API responses):
Use 'cqknow cache_stats' to view LLM cache statistics. Use 'cqknow export_cache' to export LLM cache entries. Use 'cqknow import_cache' to import LLM cache entries.