{"id":13536132,"url":"https://github.com/eclipse-xacc/xacc","last_synced_at":"2025-04-02T02:32:43.573Z","repository":{"id":25474155,"uuid":"104096218","full_name":"eclipse/xacc","owner":"eclipse","description":"XACC - eXtreme-scale Accelerator programming framework","archived":false,"fork":false,"pushed_at":"2024-03-23T18:58:16.000Z","size":50935,"stargazers_count":159,"open_issues_count":78,"forks_count":82,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-05-18T07:40:10.832Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://xacc.readthedocs.io","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eclipse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.EDL","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-19T15:56:59.000Z","updated_at":"2024-08-01T09:20:31.265Z","dependencies_parsed_at":"2023-02-18T17:00:25.647Z","dependency_job_id":"d9f6f06d-abd9-437f-b29c-b48fab4c4d17","html_url":"https://github.com/eclipse/xacc","commit_stats":{"total_commits":2125,"total_committers":29,"mean_commits":73.27586206896552,"dds":"0.38635294117647057","last_synced_commit":"d1edaa7ae53edc7e335f46d33160f93d6020aaa3"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse%2Fxacc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse%2Fxacc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse%2Fxacc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipse%2Fxacc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eclipse","download_url":"https://codeload.github.com/eclipse/xacc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222795273,"owners_count":17038797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T09:00:35.097Z","updated_at":"2025-04-02T02:32:34.552Z","avatar_url":"https://github.com/eclipse.png","language":"C++","funding_links":[],"categories":["Quantum SDKs"],"sub_categories":[],"readme":"![XACC](docs/assets/xacc_full_logo.svg)\n\n\n| Branch | Status |\n|:-------|:-------|\n|master | [![Linux CI](https://github.com/eclipse/xacc/actions/workflows/ci-linux.yml/badge.svg?branch=master)](https://github.com/eclipse/xacc/actions/workflows/ci-linux.yml) [![Mac CI](https://github.com/eclipse/xacc/actions/workflows/ci-mac.yml/badge.svg?branch=master)](https://github.com/eclipse/xacc/actions/workflows/ci-mac.yml) |\n|devel | [![Linux CI](https://github.com/eclipse/xacc/actions/workflows/ci-linux.yml/badge.svg?branch=xacc-devel)](https://github.com/eclipse/xacc/actions/workflows/ci-linux.yml) [![Mac CI](https://github.com/eclipse/xacc/actions/workflows/ci-mac.yml/badge.svg?branch=xacc-devel)](https://github.com/eclipse/xacc/actions/workflows/ci-mac.yml)|\n\n\n## Language and Hardware Independent Quantum Programming Framework\nXACC is an extensible compilation framework for hybrid quantum-classical computing architectures.\nIt provides extensible language frontend and hardware backend compilation components glued together\nvia a novel quantum intermediate representation. XACC currently supports quantum-classical programming\nand enables the execution of quantum kernels on IBM, Rigetti, and D-Wave QPUs, as well as a number\nof quantum computer simulators.\n\nDocumentation\n-------------\n\n* [Website and Documentation](https://xacc.readthedocs.io)\n* [API Documentation](https://ornl-qci.github.io/xacc-api-docs/)\n\nQuick Start\n-----------\nClick [![Gitpod Ready-to-Code](https://img.shields.io/badge/Gitpod-Ready--to--Code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/eclipse/xacc) \nto open up a pre-configured Eclipse Theia IDE. You should immediately be able to \nrun any of the C++ or Python examples from the included terminal:\n```bash\n[example C++ executables are in build/quantum/examples/*]\n$ build/quantum/examples/qasm/deuteron_from_qasm\n\n[example Python scripts are in python/examples/*]\n$ python3 python/examples/deuteronH2.py\n\n[run some XACC benchmarks]\n$ python3 -m xacc --benchmark python/benchmark/chemistry/benchmarks/nah_ucc1.ini \n```\nAll code is here and you can quickly start developing. We recommend \nturning on file auto-save by clicking ``File \u003e Auto Save ``.\nNote the Gitpod free account provides 100 hours of use for the month, so if \nyou foresee needing more time, we recommend our nightly docker images.\n\nThe XACC nightly docker images also serve an [Eclipse Theia IDE](https://theia-ide.org/) on port 3000. To get started, run \n```bash\n$ docker run --security-opt seccomp=unconfined --init -it -p 3000:3000 ghcr.io/eclipse/xacc/xacc:latest\n```\nNavigate to ``https://localhost:3000`` in your browser to open the IDE and get started with XACC. \n\n\nBuild from Source\n-----------------\nFull installation details can be followed [here](https://xacc.readthedocs.io/en/latest/install.html).\n\nEnsure that you have installed CMake 3.12+, a C++17 compliant compiler (GCC 8+, Clang 5+), and\nCURL development headers and libraries with OpenSSL support\n(see [prerequisites](http://xacc.readthedocs.io/en/latest/install.html#pre-requisites)).\n\nIt is also recommended (though optional) that you install BLAS and LAPACK development libraries (for various simulators),\nPython 3 development headers (for the Python API), and Libunwind (for stack trace printing).\n\nTo enable XACC Python support, ensure that `python3` is set to your desired version of Python 3. CMake will\nfind the corresponding development headers. Ensure that when you try to run XACC-enabled Python scripts\nyou are using the same `python3` executable that was set during your build.\n\nClone the repository recursively, configure with `cmake` and build with `make`\n```bash\n$ git clone https://github.com/eclipse/xacc\n$ cd xacc \u0026\u0026 mkdir build \u0026\u0026 cd build\n[default cmake call]\n$ cmake ..\n[with tests and examples]\n$ cmake .. -DXACC_BUILD_EXAMPLES=TRUE -DXACC_BUILD_TESTS=TRUE\n[now build xacc]\n$ make install\n[for a speedier build on linux]\n$ make -j$(nproc --all) install\n[and on mac os x]\n$ make -j$(sysctl -n hw.physicalcpu) install\n[if built with tests, run them]\n$ ctest --output-on-failure\n```\n\nCMake options:\n\n* `XACC_DEPS_EXTERNAL`: [Optional, default = `OFF`] XACC to search externally for its third-party dependencies. When turning on, XACC will try to use `find_package` to locate its required dependencies before falling back to using the builtin submodules in `tpls`.\n\n\t**Note**: when turning on this flag, it is your responsibility to manage the compatibility of those `tpls`. For example, XACC compilation may fail if the externally-installed library version is incompatible with the builtin one.\n\nSee full documentation for all CMake optional arguments.\n\nYour installation will be in `$HOME/.xacc`. If you built with the Python API,\nbe sure to update your `PYTHONPATH` environment variable to point to the installation:\n```bash\n$ export PYTHONPATH=$PYTHONPATH:$HOME/.xacc\n```\n\nYou will probably want the XACC default simulator, TNQVM. To install, run the following:\n```bash\n$ git clone https://github.com/ornl-qci/tnqvm\n$ cd tnqvm \u0026\u0026 mkdir build \u0026\u0026 cd build\n$ cmake .. -DXACC_DIR=~/.xacc\n$ make install\n```\n\nQuestions, Bug Reporting, and Issue Tracking\n--------------------------------------------\n\nQuestions, bug reporting and issue tracking are provided by GitHub. Please\nreport all bugs by creating a new issue with the bug tag. You can ask\nquestions by creating a new issue with the question tag.\n\nLicense\n-------\n\nXACC is dual licensed - [Eclipse Public License](LICENSE.EPL) and [Eclipse Distribution License](LICENSE.EDL).\n\nCite XACC\n----------\nIf you use XACC in your research, please use the following citation\n```\n@article{xacc_2020,\n\tdoi = {10.1088/2058-9565/ab6bf6},\n\turl = {https://doi.org/10.1088%2F2058-9565%2Fab6bf6},\n\tyear = 2020,\n\tmonth = {feb},\n\tpublisher = {{IOP} Publishing},\n\tvolume = {5},\n\tnumber = {2},\n\tpages = {024002},\n\tauthor = {Alexander J McCaskey and Dmitry I Lyakh and Eugene F Dumitrescu and Sarah S Powers and Travis S Humble},\n\ttitle = {{XACC}: a system-level software infrastructure for heterogeneous quantum{\\textendash}classical computing},\n\tjournal = {Quantum Science and Technology}\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-xacc%2Fxacc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feclipse-xacc%2Fxacc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipse-xacc%2Fxacc/lists"}