kannaka-quantum

Real quantum capabilities for Kannaka, executed on actual quantum backends via qBraid.

Kannaka's memory is a Holographic Resonance Medium — recall is wave interference, and "attention acts as gravity: wavefronts whose phase/amplitude align with the query are pulled forward." That is, nearly verbatim, the definition of quantum amplitude amplification. This package makes the correspondence literal.

It ships two surfaces over the same core:

• a JSON CLI — the Kannaka coding agent shells out to it to write & run quantum programs;

• an MCP server — any MCP client (Claude Code, the kannaka-tui harness, other agents) gets the same tools.

Capabilities

Related MCP server: NotebookLM MCP Server (Security Hardened)

Install

pip install -e .          # from this directory

Authentication uses a qBraid API key, resolved from (in order): QBRAID_API_KEY, a saved ~/.qbraid/qbraidrc (QbraidProvider(api_key=...).save_config()), or ~/Downloads/QBraid.txt.

CLI

kannaka-quantum devices --online
kannaka-quantum run --qasm-file bell.qasm --shots 200
kannaka-quantum qrng --bits 16
kannaka-quantum recall --amplitudes 0.1,0.9,0.2,0.15 --labels alpha,beta,gamma,delta

Every command prints one JSON object (errors included).

MCP server

kannaka-quantum mcp        # stdio transport

Register with Claude Code:

claude mcp add kannaka-quantum -- python -m kannaka_quantum mcp

…then any agent can call quantum_devices, run_circuit, quantum_random, and resonance_recall.

Example: resonance recall

$ kannaka-quantum recall --amplitudes 0.1,0.9,0.2,0.15 --labels alpha,beta,gamma,delta
{"distribution": {"alpha": 2, "beta": 775, "gamma": 240, "delta": 7},
 "quantum_top": "beta", "classical_top": "beta", "agree": true,
 "qubits": 2, "candidates": 4, "amplified": true,
 "device": "qbraid:qbraid:sim:qir-sv"}

Amplitude amplification sharpens the prepared resonance state toward the strongest memory — the recall ran on a quantum computer, and it agrees with the classical argmax.

License

MIT.