{"id":48664329,"url":"https://github.com/plutoniumm/qudit","last_synced_at":"2026-04-10T10:34:27.746Z","repository":{"id":257812352,"uuid":"868431599","full_name":"plutoniumm/qudit","owner":"plutoniumm","description":"numpy based simple qudit simulations in python","archived":false,"fork":false,"pushed_at":"2026-04-05T10:43:54.000Z","size":2876,"stargazers_count":0,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-05T11:05:45.984Z","etag":null,"topics":["quantum-computing","qudits"],"latest_commit_sha":null,"homepage":"https://plutoniumm.github.io/qudit/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/plutoniumm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-10-06T11:24:03.000Z","updated_at":"2026-04-05T10:43:59.000Z","dependencies_parsed_at":"2026-02-10T12:06:13.116Z","dependency_job_id":null,"html_url":"https://github.com/plutoniumm/qudit","commit_stats":null,"previous_names":["plutoniumm/qudit"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/plutoniumm/qudit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plutoniumm%2Fqudit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plutoniumm%2Fqudit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plutoniumm%2Fqudit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plutoniumm%2Fqudit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plutoniumm","download_url":"https://codeload.github.com/plutoniumm/qudit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plutoniumm%2Fqudit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31638665,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T07:40:12.752Z","status":"ssl_error","status_checked_at":"2026-04-10T07:40:11.664Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["quantum-computing","qudits"],"created_at":"2026-04-10T10:34:24.460Z","updated_at":"2026-04-10T10:34:27.730Z","avatar_url":"https://github.com/plutoniumm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://raw.githubusercontent.com/plutoniumm/qudit/refs/heads/main/docs/public/icons/favi.svg\" alt=\"icon\" width=\"100\" height=\"100\" align=\"right\" name=\"icon\"/\u003e\n\n### `qudit`\n\nHigh performance simulations for qudit systems. To make qudit machine learning, qudit error correction, and qudit circuit simulation easier. Qudit is made fully around `pytorch` to make it easy to mix and match tools without worrying about type errors.\n\n[![PyPI version](https://badge.fury.io/py/qudit.svg)](https://pypi.org/project/qudit/)\n\n```bash\npip install qudit\n```\n\n## Quickstart\n\nIn most cases it should not matter if you mix and match `pytorch` with `qudit` since most abstractions are built on top of `pytorch` tensors. The following is two examples to do the same thing, one using the `Circuit` class and the other manually using the matrices.\n\n**Using the `Circuit` class:**\n\n```python\nfrom qudit import Circuit\nimport torch as pt\n\nC = Circuit(2, dim=2)  # 2 qBits with d=2\nG = C.gates[2]\n\nC.gate(G.H, dits=[0])\nC.gate(G.CX, dits=[0, 1])\n\nket0 = pt.zeros(2**2)\nket0[0] = 1.0  # |00\u003e\n\nprint(C(ket0))  # [1. 0. 0. 1.]/rt2\n```\n\n## Contributing\nQudit has a small shell scripts used to generate documentation and run tests. If you want to contribute, please fork the repo and make a pull request with your changes. The running script is `do`.\n\n#### Commands\n\n- `./do help`\n  - Helper for common workflows (build, tests, docs, etc.)\n- `./do build`\n  - Builds `sdist` + `wheel` and runs `twine check dist/*`.\n- `./do deploy`\n  - Uploads `dist/*` to PyPI via `twine upload` using an API token.\n  - Token is read from `FILE` (defaults to `.vscode/token.env`).\n- `./do test`\n  - Runs the Python test scripts in `./tests`.\n- `./do prof`\n  - Profiles `./tests/bench_fast.py` with `cProfile` and opens `snakeviz`.\n- `./do head`\n  - Runs `python ./view/headers.py` (used by the docs pipeline).\n- `./do docs dev`\n  - Runs the docs dev server (`npm run dev`).\n- `./do docs build`\n  - Builds the docs (`npm run build`).\n\n#### Common workflows\n\n```bash\n# run test scripts\n./do test\n\n# build packages locally\n./do build\n\n# build docs\n./do docs build\n\n# docs dev server\n./do docs dev\n```\n\n#### PyPI token setup (for `deploy`)\n\nCreate a file containing only your PyPI API token (no `export`, no quotes):\n\n- default location: `.vscode/token.env`\n- or specify a different file via `FILE=path/to/token.env`\n\nExample:\n\n```bash\nFILE=.vscode/token.env ./do deploy\n```\n\n## Acknowledgements\nMany many thanks to [Sai Sakunthala](https://github.com/Sai-sakunthala) and [R-Phoenix](https://github.com/R-Phoenix) for testing and fixing bugs!\n\nThis library is built on top of pytorch, and takes ideas from Qiskit, Cirq, and QuDiet.\n\n### Caveats\n`qudit` does not, and will not support openQASM in the near future since hardware is not a goal. There are plans for some amount of interoperability with other qudit simulators, however that will be a long term goal and not a near term one. We will first make qudit stable.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplutoniumm%2Fqudit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplutoniumm%2Fqudit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplutoniumm%2Fqudit/lists"}