A lightweight, LLVM-based quantum software stack for hybrid classical–quantum computing.

Vision • Projects • Features • Getting Started • Contributing • Community

QCFlow aims to build an open, practical quantum software ecosystem that:

• Bridges classical and quantum computation with a unified programming and task-flow model.
• Provides a lightweight, LLVM-based quantum compiler toolchain that is easy to integrate and extend.
• Defines and evolves quantum programming standards (such as QDBC) for reproducible and portable quantum workloads.
• Enables data-driven, AI-assisted quantum programming through plugins and tooling.

Our long-term goal is to make hybrid classical–quantum applications as natural to develop and deploy as today’s parallel and distributed applications.

The following projects are under active development within the QCFlow ecosystem.

• QLLVM: Quantum LLVM Compiler Infrastructure
  An LLVM-based quantum compiler and IR framework for hybrid classical–quantum workloads.
  Provides frontend hooks, quantum-aware passes, and backend interfaces to simulators and hardware.
  Repo: QCFlow/QLLVM

• QCFlow QDBC Standard (planning)
  Quantum/Distributed Benchmark & Coding standard (QDBC) and related specification documents.
  Planned repo: qdbc-spec

• QCFlow IDE & Plugins (planning)
  Editor/IDE integrations (e.g., VS Code) with syntax highlighting, diagnostics, and AI-assisted quantum coding.
  Planned repo: qcflow-ide

• QCFlow Runtime & Task Flow (planning)
  Runtime components and scheduling framework for classical–quantum task orchestration and resource management.
  Planned repo: qcflow-runtime

• QCFlow Examples & Tutorials (planning)
  Sample projects, teaching materials, and best practices for building hybrid applications with QCFlow tools.
  Planned repo: qcflow-examples

• LLVM-based architecture

  • Reuses the mature LLVM infrastructure.
  • Enables classical + quantum optimization passes in a unified pipeline.
  • Easy to integrate into existing compiler toolchains and research prototypes.

• Hybrid task flow

  • Models classical control and quantum kernels in a single workflow.
  • Aims to target heterogeneous backends (simulators, real quantum hardware, and HPC nodes).

• Open standards (QDBC)

  • Standardizes program representation, benchmarks, and interfaces.
  • Promotes reproducibility and cross-platform compatibility.

• Tooling & plugins

  • IDE extensions for a better developer experience.
  • Foundations for AI-assisted coding and data-driven optimization.

• Research–to–production friendly

  • Designed to support both academic research and engineering deployment.

For now, the main entry point to the QCFlow ecosystem is the QLLVM project:

• 👉 QLLVM repository: https://github.com/QCFlow/QLLVM

Please refer to the QLLVM README for build instructions, basic examples, and integration notes.

As the ecosystem evolves, this organization profile will link to more components (runtime, IDE plugins, examples, etc.).

We welcome issues, discussions, and contributions around:

• Quantum IR design and optimization passes.
• Hybrid classical–quantum compilation workflows.
• QDBC and other open standards.
• Tooling, visualization, and debugging support.

Contribution guidelines and governance documents will be added as the project grows.
In the meantime, feel free to open issues or discussions in QLLVM.

• GitHub Org: QCFlow
• Core compiler project: QCFlow/QLLVM

More communication channels (chat, mailing list, etc.) will be announced here when they are available.