{"id":21040,"library":"cirq-ionq","title":"cirq-ionq","description":"A Cirq package to simulate and connect to IonQ quantum computers. Version 1.6.1, released as part of Cirq v1.6.1. Supports Python >=3.11.0. Releases follow Cirq's release cadence, approximately quarterly.","status":"active","version":"1.6.1","language":"python","source_language":"en","source_url":"https://github.com/quantumlib/cirq","tags":["quantum computing","ionq","cirq","quantum simulator"],"install":[{"cmd":"pip install cirq-ionq","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Required for core Cirq functionality.","package":"cirq-core","optional":false}],"imports":[{"wrong":"from cirq_ionq import IonQDevice","symbol":"Service","correct":"from cirq_ionq import Service"},{"symbol":"Sampler","correct":"from cirq_ionq import Sampler"},{"symbol":"Job","correct":"from cirq_ionq import Job"}],"quickstart":{"code":"import cirq\nfrom cirq_ionq import IonQSimulator\n\n# Get API key from environment (set IONQ_API_KEY)\nimport os\napi_key = os.environ.get('IONQ_API_KEY', '')\nif not api_key:\n    print('Set IONQ_API_KEY environment variable')\n    exit(1)\n\nsimulator = IonQSimulator(api_key=api_key)\nq0, q1 = cirq.LineQubit.range(2)\ncircuit = cirq.Circuit(cirq.H(q0), cirq.CNOT(q0, q1), cirq.measure(q0, q1))\nresult = simulator.run(circuit, repetitions=100)\nprint(result.histogram(key='0,1'))","lang":"python","description":"Run a Bell state circuit on the IonQ simulator."},"warnings":[{"fix":"Upgrade Python to 3.11 or later.","message":"Python 3.11 minimum: From version 1.6.0, cirq-ionq requires Python >=3.11.0. Older Python versions will fail to install.","severity":"breaking","affected_versions":">=1.6.0"},{"fix":"Use `from cirq_ionq import IonQSimulator`.","message":"Import from cirq_ionq not cirq.ionq: The correct import path is `from cirq_ionq import ...`. Using `cirq.ionq` will raise ImportError.","severity":"gotcha","affected_versions":"all"},{"fix":"Set `IONQ_API_KEY` env var or use `IonQSimulator(api_key=...)` as documented.","message":"API key via environment variable: The IonQ API key must be set via the `IONQ_API_KEY` environment variable or passed to the sampler constructor. Passing via `cirq_ionq.Service` constructor is deprecated.","severity":"deprecated","affected_versions":">=1.6.0"}],"env_vars":null,"search_vec":"'1.6.1':16 '3.11.0':25 'approxim':32 'cadenc':31 'cirq':2,5,21,28,37 'cirq-ionq':1 'comput':14,35 'connect':10 'follow':27 'ionq':3,12,36 'packag':6 'part':19 'python':24 'quantum':13,34,38 'quarter':33 'releas':17,26,30 'simul':8,39 'support':23 'v1.6.1':22 'version':15","created_at":"2026-04-27T16:57:45.771231+00:00","updated_at":"2026-04-27T16:57:45.771231+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.6.1","cli_name":"","cli_version":null,"type":"library","homepage":"https://quantumai.google/cirq","github":"http://github.com/quantumlib/cirq","docs":null,"changelog":null,"pypi":"https://pypi.org/project/cirq-ionq/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml","gcp"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-30","last_verified":"2026-06-30","next_check":"2026-07-30","install_tag":null}}