PyTran 🚀

Hybrid Python–Fortran Language for Quantum Computing & HPC

PyTran is a research-grade language runtime that unifies:

• Python expressiveness
• Fortran-class numerical performance
• Optional GPU acceleration
• Quantum–classical hybrid workflows

It is designed for HPC, quantum simulation, and AI-assisted scientific computing, while remaining easy to install and run locally.

---

✨ Key Features

• 🔬 Hybrid kernels with Python syntax and Fortran-optimized execution
• ⚛️ Quantum-ready abstractions (circuits, qubits, operators, states)
• 🧠 AI-assisted decorators for generation and optimization
• ⚡ Optional GPU acceleration (CuPy)
• 🧩 Modular transpiler and code-generation architecture
• 🛠️ Works-on-first-run bootstrap installer

---

📦 Installation

Prerequisites

• Linux (Debian / Ubuntu / RHEL tested)
• bash and curl
• No system Python required (isolated environment created automatically)

---

CPU-only install (default)

tar -xzf pytran-0.1.0.tar.gz
cd pytran-0.1.0
./bootstrap.sh

This installs PyTran into an isolated environment under:

~/.local/share/pytran/envs/pytran

---

GPU-enabled install (optional)

GPU support is opt-in. CPU installs do not download CUDA or CuPy.

./bootstrap.sh --extras gpu

---

Activate the environment

source ~/.local/share/pytran/envs/pytran/bin/activate

If you installed using a local prefix (for example --prefix ./.pytran_prefix):

source ./.pytran_prefix/envs/pytran/bin/activate

---

🧪 Verify Installation

Quick import check:

python -c "import pytran; print('PyTran imported successfully')"

Run the built-in installation test:

python pytran/test_installation.py

---

🧠 Example: Quantum Circuit

from pytran import quantum_circuit, Circuit

@quantum_circuit
def bell_pair() -> Circuit:
    circuit = Circuit(2)
    circuit.h(0)
    circuit.cnot(0, 1)
    return circuit

c = bell_pair()
print(c.operations)

---

🏗️ Project Structure

• pytran/core – decorators, types, language semantics
• pytran/transpiler – IR, optimization, code generation
• pytran/fortran – high-performance numerical kernels
• pytran/cuda – optional GPU backends
• pytran/quantum – quantum abstractions and workflows

---

🔐 Release Integrity

Verify the release checksum:

sha256sum -c pytran-0.1.0.tar.gz.sha256

---

📚 Status

• Version: 0.1.0
• Platform: Linux
• Stability: Research / Early-Access
• Distribution: GitHub Releases
• License: (add license if applicable)

---

🧭 Roadmap (High-Level)

• Native Fortran compilation pipeline
• CUDA kernel fusion and scheduling
• Quantum backend adapters (IBM, simulators)
• PyPI and Conda distribution
• Language server and IDE tooling

---

🤝 Contributing

PyTran is under active development. Issues, discussions, and contributions are welcome.

---

👤 Creator & Maintainer

Amit Brahmbhatt Founder & Lead Architect, Quantum-Clarity LLC