Metadata-Version: 2.4
Name: aumplus
Version: 25.0.0
Summary: ॐ+ (AUM+) — The world's first Sanskrit-grammar quantum programming language
Author: Prateek Gupta, Shashank Gupta
Author-email: Gaurav Gupta <gaurav@aumtrix.com>
License: Proprietary — All Rights Reserved
Project-URL: Homepage, https://aumtrix.com/aum
Project-URL: Documentation, https://aumtrix.com/docs
Project-URL: IANA Registration, https://aumtrix.com/aum
Project-URL: Company, https://aumtrix.com
Keywords: aum,quantum,sanskrit,panini,programming-language,quantum-computing,compiler,aumtrix,vedic,darshana
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Software Development :: Compilers
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# ॐ+ (AUM+) — The .aum Programming Language

**The world's first Sanskrit-grammar quantum programming language.**

[![IANA](https://img.shields.io/badge/IANA-application%2Fvnd.aumtrix.aum-orange)](https://aumtrix.com/aum)
[![Python](https://img.shields.io/badge/Python-%E2%89%A53.10-blue)](https://python.org)
[![License](https://img.shields.io/badge/License-Proprietary-red)](https://aumtrix.com)
[![Dependencies](https://img.shields.io/badge/Dependencies-ZERO-green)](https://aumtrix.com/aum)

## Install

```bash
pip install aumplus
```

**Zero dependencies.** Python 3.10+ stdlib only. Nothing else installed.

## Quick Start

### Write a .aum file

```
॥ बेल युग्म — Bell State ॥

परिपथ बेल:
    कर्ता[०] अध्यारोप
    कर्ता[०] कर्म[१] बन्धन
```

### Run it

```bash
aumplus run bell.aum
```

Output:
```
  ✅ Compiled: 2 qubits, 2 gates

  Results (4096 shots, SvadeshiSimulator):
    |00⟩:  2048 ( 50.0%) ████████████████████
    |11⟩:  2048 ( 50.0%) ████████████████████
```

## Commands

| Command | Description |
|---------|-------------|
| `aumplus compile <file.aum>` | Compile .aum → quantum circuit |
| `aumplus run <file.aum>` | Compile + simulate |
| `aumplus check <file.aum>` | Validate .aum source |
| `aumplus qasm <file.aum>` | Export to OpenQASM 2.0 |
| `aumplus test` | Run 796+ internal tests |
| `aumplus audit` | Pāṇini compliance audit |
| `aumplus repl` | Interactive Sanskrit REPL |
| `aumplus version` | Show version info |
| `aumplus info` | Show language capabilities |

## Python API

```python
import aumplus

# Compile
qc = aumplus.compile('परिपथ bell:\n    कर्ता[0] अध्यारोप\n    कर्ता[0] कर्म[1] बन्धन')
print(qc.draw())

# Run
counts = aumplus.run('परिपथ bell:\n    कर्ता[0] अध्यारोप\n    कर्ता[0] कर्म[1] बन्धन')
print(counts)  # {'00': ~2048, '11': ~2048}

# Audit
print(aumplus.audit())
```

## .aum File Format

- **Extension:** `.aum`
- **MIME type:** `application/vnd.aumtrix.aum`
- **IANA registration:** Ticket #1452483
- **Encoding:** UTF-8 (Devanāgarī + ASCII)
- **Patent:** USPTO PROV-005

## What Makes AUM+ Different

| Feature | AUM+ | Qiskit | Cirq |
|---------|------|--------|------|
| Grammar-driven compilation | ✅ Pāṇini sūtras | ❌ | ❌ |
| 6 darśana engines in compiler | ✅ | ❌ | ❌ |
| 7/7 kāraka bug classes | ✅ | ❌ | ❌ |
| 10/10 lakāra temporal modes | ✅ | ❌ | ❌ |
| Zero dependencies | ✅ | ❌ 50+ deps | ❌ 30+ deps |
| Own file extension (.aum) | ✅ IANA registered | ❌ uses .py | ❌ uses .py |
| Built-in simulator | ✅ SvadeshiSimulator | Separate (Aer) | Separate |
| Noise as guṇas | ✅ sattva/rajas/tamas | ❌ | ❌ |
| 2,500 years of math executing | ✅ 30 scholars | ❌ | ❌ |

## Architecture

```
.aum source
  → AumLexer (3-layer: structural → morphological → keyword)
  → AumParser (PrakriyaEngine sūtra-driven)
  → AumValidator (kāraka 7/7 bug classes)
  → SandhiOptimizer (158+ rules, multi-pass fusion)
  → LakaraCompiler (10 temporal strategies)
  → VibhaktiEnforcer (7 case validations)
  → NyāyaProver (5-part syllogism verification)
  → GuṇaNoiseModel (sattva/rajas/tamas)
  → DarśanaEngine (6/6 unified philosophy pipeline)
  → AumCodeGen → SvadeshiCircuit
```

## License

**Proprietary.** © 2026 Manu Martin Inc DBA Aumtrix & KishKindha International Pvt Ltd. All rights reserved. USPTO Provisional PROV-005.

## Links

- **Website:** [aumtrix.com/aum](https://aumtrix.com/aum)
- **Company:** [aumtrix.com](https://aumtrix.com)
- **IANA:** application/vnd.aumtrix.aum (#1452483)
