CLI Reference¶

Complete command-line interface reference for Q-Memetic AI. All commands require a valid QuantumMeta license.

Global Options¶

qmemetic --license-key YOUR_KEY --verbose [COMMAND]

Option	Environment Variable	Description
`--license-key`	`QMEMETIC_LICENSE_KEY`	QuantumMeta license key (required)
`--verbose, -v`	-	Enable verbose debug output
`--version`	-	Show version information
`--help`	-	Show help message

Commands Overview¶

Command	Purpose	License Tier
`evolve`	Evolve memes using genetic algorithms	Core
`sync`	Federated network synchronization	Pro
`entangle`	Quantum entanglement visualization	Core
`create`	Create new memes	Core
`analyze`	Deep meme analysis	Core
`status`	System health monitoring	Core
`license`	License management	All

evolve¶

Evolve memes through genetic algorithms over multiple generations.

Usage¶

qmemetic evolve [OPTIONS]

Options¶

Option	Type	Default	Description
`--input, -i`	TEXT	Required	Input file or text content to evolve
`--generations, -g`	INTEGER	5	Number of evolution generations
`--population, -p`	INTEGER	20	Population size for evolution
`--output, -o`	PATH	-	Output file for evolved memes (JSON)
`--visualize`	FLAG	False	Create evolution visualization

Examples¶

# Evolve text content
qmemetic evolve --input "AI will transform society" --generations 10

# Evolve from file with visualization
qmemetic evolve -i research_paper.txt -g 15 -p 50 --visualize

# Save results to file
qmemetic evolve -i "quantum computing" -o evolved_memes.json

# Large-scale evolution
qmemetic evolve -i dataset.txt -g 20 -p 100 --output results.json

Output¶

Evolution results are displayed as a ranked table:

Evolution Results:
┏━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Rank ┃ Fitness  ┃ Generation  ┃ Content                        ┃
┡━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 1    │ 0.847    │ 8           │ AI will revolutionize...       │
│ 2    │ 0.823    │ 6           │ Artificial intelligence...     │
│ 3    │ 0.798    │ 9           │ Machine learning will...       │
└──────┴──────────┴─────────────┴─────────────────────────────────┘

sync¶

Synchronize with the federated memetic network.

Usage¶

qmemetic sync [OPTIONS]

Options¶

Option	Type	Default	Description
`--node-id`	TEXT	-	Specific node ID to sync with
`--mode`	CHOICE	bidirectional	Sync mode: push, pull, bidirectional
`--timeout`	INTEGER	30	Sync timeout in seconds

Examples¶

# Bidirectional sync with network
qmemetic sync

# Push memes to network
qmemetic sync --mode push

# Pull latest memes
qmemetic sync --mode pull --timeout 60

# Sync with specific node
qmemetic sync --node-id research_lab_2 --mode bidirectional

Output¶

Sync Results:
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ Metric           ┃ Value    ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ Nodes Contacted  │ 5        │
│ Memes Sent       │ 23       │
│ Memes Received   │ 47       │
│ Errors           │ 0        │
└──────────────────┴──────────┘

Requirements¶

Pro or Enterprise license tier
Network connectivity
Federated mode enabled

entangle¶

Explore and visualize quantum entanglement networks.

Usage¶

qmemetic entangle [OPTIONS]

Options¶

Option	Type	Default	Description
`--meme-id`	TEXT	Required	Starting meme ID for exploration
`--depth`	INTEGER	3	Exploration depth
`--layout`	CHOICE	force_directed	Visualization layout algorithm
`--output, -o`	PATH	-	Output file for visualization

Layout Options¶

force_directed - Spring-force algorithm
hierarchical - Tree-like hierarchy
circular - Circular arrangement
grid - Grid-based layout
random - Random positioning

Examples¶

# Basic entanglement exploration
qmemetic entangle --meme-id abc123 --depth 5

# Custom layout with output
qmemetic entangle --meme-id xyz789 --layout hierarchical -o network.html

# Deep exploration
qmemetic entangle --meme-id def456 --depth 10 --layout circular

Output¶

Quantum Walk Completed! Visited 15 unique memes.
Walk path: abc123 → def456 → ghi789 → jkl012...

Network Statistics:
┏━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ Metric                 ┃ Value    ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ Total Nodes            │ 45       │
│ Total Edges            │ 127      │
│ Average Entanglement   │ 0.634    │
│ Network Density        │ 0.123    │
│ Clustering Coefficient │ 0.789    │
└────────────────────────┴──────────┘

Entanglement visualization saved to: noosphere_visualization.html

create¶

Create new memes with metadata and vector representations.

Usage¶

qmemetic create [OPTIONS]

Options¶

Option	Type	Default	Description
`--content`	TEXT	Required	Meme content to create
`--author`	TEXT	cli_user	Author name
`--domain`	TEXT	-	Content domain
`--tags`	TEXT	-	Comma-separated tags

Examples¶

# Simple meme creation
qmemetic create --content "The future is quantum"

# Meme with full metadata
qmemetic create \
  --content "AI will revolutionize healthcare" \
  --author "dr_smith" \
  --domain "medical_ai" \
  --tags "AI,healthcare,innovation"

# Research meme
qmemetic create \
  --content "Quantum entanglement enables secure communication" \
  --author "researcher" \
  --domain "quantum_physics" \
  --tags "quantum,security,communication"

Output¶

Meme created successfully!

Created Meme:
┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Property          ┃ Value                                                                     ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ ID                │ meme_abc123def456                                                         │
│ Content           │ AI will revolutionize healthcare by enabling personalized treatment...  │
│ Author            │ dr_smith                                                                  │
│ Domain            │ medical_ai                                                                │
│ Tags              │ AI, healthcare, innovation                                                │
│ Fitness           │ 0.742                                                                     │
│ Vector Dimension  │ 384                                                                       │
└───────────────────┴───────────────────────────────────────────────────────────────────────────┘

analyze¶

Perform comprehensive analysis of specific memes.

Usage¶

qmemetic analyze MEME_ID

Arguments¶

Argument	Type	Description
`MEME_ID`	TEXT	ID of the meme to analyze

Examples¶

# Basic meme analysis
qmemetic analyze meme_abc123def456

# Analyze recently created meme
qmemetic analyze $(qmemetic create --content "test" | grep "ID:" | cut -d' ' -f2)

Output¶

The analysis provides comprehensive information about the meme:

Analyzing meme: meme_abc123def456

Basic Information:
┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Property          ┃ Value                                           ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Meme ID           │ meme_abc123def456                               │
│ Content           │ AI will revolutionize healthcare...            │
│ Author            │ dr_smith                                        │
│ Domain            │ medical_ai                                      │
│ Generation        │ 3                                               │
│ Created           │ 2025-07-17 14:30:22                           │
└───────────────────┴─────────────────────────────────────────────────┘

Fitness Metrics:
┏━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ Metric                 ┃ Value    ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ Overall Fitness        │ 0.742    │
│ Semantic Coherence     │ 0.856    │
│ Novelty Score          │ 0.634    │
│ Domain Relevance       │ 0.892    │
│ Evolution Potential    │ 0.723    │
└────────────────────────┴──────────┘

Network Position:
┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ Metric                ┃ Value    ┃
┡━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│ Centrality            │ 0.567    │
│ Connected Memes       │ 8        │
│ Clustering Coefficient│ 0.445    │
│ Average Path Length   │ 2.3      │
└───────────────────────┴──────────┘

Connected Memes (3):
  • meme_def789ghi012: Machine learning algorithms in medical diagnosis...
  • meme_ghi345jkl678: Personalized medicine through AI analytics...
  • meme_jkl901mno234: Healthcare data security and privacy concerns...

status¶

Display comprehensive system status and health metrics.

Usage¶

qmemetic status [OPTIONS]

Options¶

Option	Type	Default	Description
`--format`	CHOICE	table	Output format: table, json

Examples¶

# System status overview
qmemetic status

# JSON output for scripting
qmemetic status --format json

# Parse specific metrics
qmemetic status --format json | jq '.data_metrics.total_memes'

Output¶

Q-Memetic AI System Status

System Information:
┏━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Property        ┃ Value                                                                    ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Session ID      │ session_abc123def456...                                                  │
│ Uptime          │ 3847.2 seconds                                                           │
│ Federated Mode  │ ❌                                                                       │
└─────────────────┴──────────────────────────────────────────────────────────────────────────┘

License Status:
┏━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Property        ┃ Value                                                                    ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Tier            │ Pro                                                                      │
│ Valid           │ ✅                                                                       │
│ Features        │ 15                                                                       │
└─────────────────┴──────────────────────────────────────────────────────────────────────────┘

Data Metrics:
┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Metric              ┃ Count                                                                ┃
┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Total Memes         │ 1,247                                                                │
│ Entanglement Edges  │ 5,634                                                                │
│ Cognitive Models    │ 23                                                                   │
│ Average Fitness     │ 0.678                                                                │
└─────────────────────┴──────────────────────────────────────────────────────────────────────┘

Network Health:
┏━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Metric                  ┃ Value                                                             ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Graph Density           │ 0.123                                                             │
│ Connected Components    │ 12                                                                │
│ Average Clustering      │ 0.567                                                             │
└─────────────────────────┴───────────────────────────────────────────────────────────────────┘

license¶

Manage QuantumMeta license and feature access.

Usage¶

qmemetic license [OPTIONS]

Options¶

Option	Type	Description
`--status`	FLAG	Show detailed license status
`--validate`	FLAG	Validate current license
`--features`	FLAG	List available features

Examples¶

# Show license status
qmemetic license --status

# Validate license
qmemetic license --validate

# List available features
qmemetic license --features

# Show everything
qmemetic license --status --features

Output¶

License Management

License Status:
┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Property          ┃ Value                                                                    ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Valid             │ ✅ Yes                                                                   │
│ Tier              │ Pro                                                                      │
│ Features          │ 15                                                                       │
│ Expires           │ 2026-07-17 14:30:22                                                     │
│ Hardware ID       │ hw_abc123def456...                                                       │
└───────────────────┴──────────────────────────────────────────────────────────────────────────┘

License Limits:
  • Max concurrent memes: 10,000
  • Max federated nodes: 50
  • Evolution generations: Unlimited
  • API calls per hour: 10,000

Capabilities:
  • Basic evolution: ✅
  • Quantum entanglement: ✅
  • Federated learning: ✅
  • Advanced analytics: ✅
  • Custom plugins: ❌ (Enterprise only)

Available Features (15):
  ✅ basic_evolution
  ✅ visualization
  ✅ local_storage
  ✅ entanglement
  ✅ quantum_walk
  ✅ federation_basic
  ✅ cognitive_models
  ✅ batch_processing
  ✅ export_import
  ✅ analytics_basic
  ✅ mutation_llm
  ✅ crossover_advanced
  ✅ fitness_custom
  ✅ network_analysis
  ✅ performance_monitoring

Environment Variables¶

Variable	Description	Default
`QMEMETIC_LICENSE_KEY`	QuantumMeta license key	Required
`QMEMETIC_DATA_DIR`	Data storage directory	`./qmemetic_data`
`QMEMETIC_LOG_LEVEL`	Logging level	`INFO`
`QMEMETIC_MAX_MEMORY`	Memory limit (MB)	`8000`
`QMEMETIC_FEDERATION_PORT`	Federation port	`8080`
`OPENAI_API_KEY`	OpenAI API key for LLM operations	-

Exit Codes¶

Code	Meaning
0	Success
1	General error
2	License validation failed
3	Network error (federation)
4	Insufficient resources
5	Invalid input parameters

Shell Completion¶

Enable shell completion for better CLI experience:

Bash¶

# Add to ~/.bashrc
eval "$(_QMEMETIC_COMPLETE=bash_source qmemetic)"

Zsh¶

# Add to ~/.zshrc
eval "$(_QMEMETIC_COMPLETE=zsh_source qmemetic)"

Fish¶

# Add to ~/.config/fish/config.fish
eval (env _QMEMETIC_COMPLETE=fish_source qmemetic)

Troubleshooting¶

Common Issues¶

License Validation Failed

# Check license key
echo $QMEMETIC_LICENSE_KEY

# Validate manually
qmemetic license --validate

Federation Connection Issues

# Check network connectivity
qmemetic status

# Test federation
qmemetic sync --timeout 10

Performance Issues

# Monitor resource usage
qmemetic status --format json | jq '.performance'

# Reduce batch size
qmemetic evolve -i content.txt -p 10 -g 5

Debug Mode¶

Enable detailed logging:

# Verbose output
qmemetic --verbose evolve -i "test content"

# Debug logging
QMEMETIC_LOG_LEVEL=DEBUG qmemetic status

For more help, contact support: bajpaikrishna715@gmail.com