mirror of
https://github.com/blackboxprogramming/quantum-math-lab.git
synced 2026-03-17 07:57:25 -05:00
1adcb62de3
- Update LICENSE to proprietary (NOT for commercial resale) - Add/enhance README with BlackRoad branding - Add copyright notice (© 2026 BlackRoad OS, Inc.) - Add CONTRIBUTING.md with brand compliance guidelines - Add GitHub Actions workflow with brand checks - CEO: Alexa Amundson - Designed for 30k agents + 30k employees - Part of 578-repo BlackRoad Empire Core Product: API layer above Google/OpenAI/Anthropic managing AI model memory and continuity, enabling companies to operate exclusively by AI. ✨ Repository now enterprise-grade and legally protected 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
95 lines
2.7 KiB
Markdown
95 lines
2.7 KiB
Markdown
> ⚗️ **Research Repository**
|
||
>
|
||
> This is an experimental/research repository. Code here is exploratory and not production-ready.
|
||
> For production systems, see [BlackRoad-OS](https://github.com/BlackRoad-OS).
|
||
|
||
---
|
||
|
||
# Quantum Math Lab
|
||
|
||
Quantum Math Lab pairs a lightweight quantum circuit simulator with concise
|
||
summaries of landmark unsolved problems in mathematics. The project is designed
|
||
for experimentation and self-study: you can build and inspect quantum states in
|
||
pure Python while browsing short descriptions of famous conjectures.
|
||
|
||
## Features
|
||
|
||
- **State-vector simulator** implemented in [`quantum_simulator.py`](quantum_simulator.py)
|
||
with Hadamard, Pauli-X and controlled-NOT gates, custom unitaries and
|
||
measurement utilities.
|
||
- **Problem compendium** in [`problems.md`](problems.md) covering ten influential
|
||
open problems such as the Riemann Hypothesis, P vs NP and the Navier–Stokes
|
||
regularity question.
|
||
- **Automated tests** demonstrating the simulator’s behaviour, built with
|
||
`pytest`.
|
||
|
||
## Getting started
|
||
|
||
1. **Install dependencies**
|
||
|
||
```bash
|
||
python -m venv .venv
|
||
source .venv/bin/activate
|
||
pip install -r requirements.txt # see below if the file is absent
|
||
```
|
||
|
||
If a `requirements.txt` file is not present, simply install NumPy and pytest:
|
||
|
||
```bash
|
||
pip install numpy pytest
|
||
```
|
||
|
||
2. **Experiment with the simulator**
|
||
|
||
```python
|
||
from quantum_simulator import QuantumCircuit
|
||
|
||
circuit = QuantumCircuit(2)
|
||
circuit.hadamard(0)
|
||
circuit.cnot(0, 1)
|
||
print(circuit.probabilities()) # {'00': 0.5, '11': 0.5}
|
||
result = circuit.measure(rng=np.random.default_rng())
|
||
print(result.counts)
|
||
```
|
||
|
||
3. **Review the unsolved problems** by opening [`problems.md`](problems.md) for
|
||
high-level summaries and references.
|
||
|
||
## Running the tests
|
||
|
||
Use `pytest` to execute the simulator tests:
|
||
|
||
```bash
|
||
pytest
|
||
```
|
||
|
||
The test suite verifies single-qubit gates, entanglement via the controlled-NOT
|
||
operation and measurement statistics.
|
||
|
||
## Disclaimer
|
||
|
||
This project does not attempt to solve the problems listed in `problems.md` and
|
||
is not a substitute for full-featured quantum computing frameworks such as
|
||
[Qiskit](https://qiskit.org/) or [Cirq](https://quantumai.google/cirq). It is an
|
||
educational sandbox for experimenting with qubit states and learning about open
|
||
questions in mathematics.
|
||
|
||
---
|
||
|
||
## 📜 License & Copyright
|
||
|
||
**Copyright © 2026 BlackRoad OS, Inc. All Rights Reserved.**
|
||
|
||
**CEO:** Alexa Amundson | **PROPRIETARY AND CONFIDENTIAL**
|
||
|
||
This software is NOT for commercial resale. Testing purposes only.
|
||
|
||
### 🏢 Enterprise Scale:
|
||
- 30,000 AI Agents
|
||
- 30,000 Human Employees
|
||
- CEO: Alexa Amundson
|
||
|
||
**Contact:** blackroad.systems@gmail.com
|
||
|
||
See [LICENSE](LICENSE) for complete terms.
|