qrl-qai 1.0.0

Quantum Reinforcement Learning library: environments, policies and training loops with PennyLane.

qrl-qai: The quantum analogue of OpenAI's gym python framework

---

qrl-qai is a python framework built on top of Gymnasium, PennyLane, and PyTorch to serve as a central platform for everything quantum reinforcement learning.

The current release (0.3.0) offers 5 native quantum RL style environments:

• BlochSphereV0
• CompilerV0
• ErrorChannelV0
• ExpressibilityV0
• ProbabilityV0

Check out the Quickstart guide to get started.

Additionally, each significant release has an asssociated Google Colab and Lightning AI Studio for a hassle free experience. These are especially useful for users who want to quickly test out the environments without going through the installation process.

Lightnining AI Studio contains a Streamlit playground for no-code experimentation with the environments!

Version	Google Colab	Lightning AI Studio	Documentation
0.1.0	-	-	Read The Docs
0.2.0			Read The Docs
0.3.0	-	-	Read The Docs

---

📑 Table of Contents

• Roadmap
• Installation
• Contributing
• License
• Contact

---

🗺 Roadmap

---

🚀 Installation

Install the package directly from PyPI:

pip install qrl-qai

To save the episodes as mp4 videos, it is essential to have ffmpeg installed on your system. In the absence of ffmpeg, you can run the environments but save the episodes as gif only and not mp4.

To check if you have ffmpeg installed (Windows/Linux/Mac), you can try:

ffmpeg -version

To install ffmpeg, you can follow these steps:

Using Conda

You can also install FFmpeg within a conda environment:

conda install -c conda-forge ffmpeg

Windows

Option 1: Using Chocolatey (Recommended)

If you have Chocolatey installed:

choco install ffmpeg

✅ Option 2: Manual installation

1. Go to the official FFmpeg site → Click Windows → gyan.dev builds or BtbN builds.

2. Download the latest release full build ZIP.

3. Extract it (e.g., to C:\ffmpeg).

4. Add the bin folder to your PATH:

   4.1 Press Win + R → sysdm.cpl → Advanced → Environment Variables

   4.2 Edit Path → Add new entry: C:\ffmpeg\bin

Linux

Debian / Ubuntu:

sudo apt update
sudo apt install ffmpeg -y

Fedora:

sudo dnf install ffmpeg -y

Arch Linux:

sudo pacman -S ffmpeg

macOS

Using Homebrew:

brew install ffmpeg

🤝 Contributing

See our CONTRIBUTING.md for guidelines.

📜 License

This project is licensed under the Apache 2.0 License

📬 Contact

Initiated by Jay Shah

Email: [e-mail]