# 🧬 QuantumLangChain
<p align="center">
<img src="./assests/quantum-langchain.png" alt="QuantumLangChain Logo" width="180"/>
</p>
[](https://www.python.org/downloads/)
[](#-licensing)
[](https://krish567366.github.io/Quantum-Langchain)
[](https://github.com/psf/black)
**LICENSED SOFTWARE: A composable framework for quantum-inspired reasoning, entangled memory systems, and multi-agent cooperation — engineered for next-gen artificial intelligence.**
**📧 Contact: bajpaikrishna715@gmail.com for licensing**
**⏰ 24-hour grace period available for evaluation**
---
## Licensing
**⚠️ IMPORTANT: QuantumLangChain is commercial software requiring a valid license for all features beyond the 24-hour evaluation period.**
### Quick Start with Licensing
1. **Install**: `pip install quantumlangchain`
2. **Import**: Automatically starts 24-hour evaluation
3. **Get Machine ID**: `python -c "import quantumlangchain; print(quantumlangchain.get_machine_id())"`
4. **Contact**: Email [bajpaikrishna715@gmail.com](mailto:bajpaikrishna715@gmail.com) with your machine ID
5. **Activate**: Receive and activate your license file
## 🧬 About QuantumLangChain
QuantumLangChain bridges the gap between classical AI and quantum computing, providing a unified framework for building hybrid quantum-classical AI systems with advanced memory management, multi-agent cooperation, and quantum-inspired reasoning capabilities.
## 🚀 Features
### 🔧 Core Modules
- **QLChain**: Quantum-ready chains with decoherence-aware control flows and circuit injection
- **QuantumMemory**: Reversible, entangled memory layers with hybrid vector store support
- **QuantumToolExecutor**: Tool execution router with quantum-classical API bridge
- **EntangledAgents**: Multi-agent systems with shared memory entanglement and interference-based reasoning
- **QPromptChain**: Prompt chaining with quantum-style uncertainty branching
- **QuantumRetriever**: Quantum-enhanced semantic retrieval using Grover-based subquery refinement
- **QuantumContextManager**: Temporal snapshots and dynamic context expansion
### 🧬 Advanced Capabilities
- **Decoherence-Aware Reasoning**: Simulate quantum noise impact on logic and decision trees
- **Timeline Rewriting**: Memory snapshotting, branching, and rollback of reasoning paths
- **Entangled Collaboration**: Agents with shared belief states and quantum-style communication
- **Self-Adaptive Reasoning Graphs**: Dynamic agent chain restructuring during execution
## 📦 Installation
### Basic Installation
```bash
pip install quantumlangchain
```
### Development Installation
```bash
pip install quantumlangchain[dev]
```
### Full Installation (with all optional dependencies)
```bash
pip install quantumlangchain[all]
```
### From Source
```bash
git clone https://github.com/krish567366/Quantum-Langchain.git
cd Quantum-Langchain
pip install -e .
```
## 🧠 Quick Start
### Basic Quantum Chain
```python
from quantumlangchain import QLChain, QuantumMemory
from quantumlangchain.backends import QiskitBackend
# Initialize quantum backend
backend = QiskitBackend()
# Create quantum memory
memory = QuantumMemory(
classical_dim=512,
quantum_dim=8,
backend=backend
)
# Build a quantum chain
chain = QLChain(
memory=memory,
decoherence_threshold=0.1,
circuit_depth=10
)
# Execute with quantum-classical hybrid reasoning
result = await chain.arun("Analyze the quantum implications of this dataset")
```
### Multi-Agent Entanglement
```python
from quantumlangchain import EntangledAgents, SharedQuantumMemory
# Create shared quantum memory
shared_memory = SharedQuantumMemory(agents=3, entanglement_depth=4)
# Initialize entangled agents
agents = EntangledAgents(
agent_count=3,
shared_memory=shared_memory,
interference_weight=0.3
)
# Collaborative quantum reasoning
results = await agents.collaborative_solve(
"Complex multi-dimensional optimization problem"
)
```
### Quantum-Enhanced Retrieval
```python
from quantumlangchain import QuantumRetriever
from quantumlangchain.vectorstores import HybridChromaDB
# Setup hybrid vector store
vectorstore = HybridChromaDB(
classical_embeddings=True,
quantum_embeddings=True,
entanglement_degree=2
)
# Quantum retriever with Grover enhancement
retriever = QuantumRetriever(
vectorstore=vectorstore,
grover_iterations=3,
quantum_speedup=True
)
# Enhanced semantic search
docs = await retriever.aretrieve("quantum machine learning applications")
```
## 🛠️ Supported Quantum Backends
- **Qiskit**: IBM Quantum platform integration
- **PennyLane**: Differentiable quantum programming
- **Amazon Braket**: AWS quantum computing service
- **Cirq**: Google's quantum computing framework
- **Qulacs**: High-performance quantum simulator
## 📚 Documentation
Comprehensive documentation is available at [krish567366.github.io/Quantum-Langchain](https://krish567366.github.io/Quantum-Langchain)
### Key Sections
- [Getting Started Guide](https://krish567366.github.io/Quantum-Langchain/getting-started/)
- [API Reference](https://krish567366.github.io/Quantum-Langchain/api/)
- [Quantum Concepts](https://krish567366.github.io/Quantum-Langchain/concepts/)
- [Integration Tutorials](https://krish567366.github.io/Quantum-Langchain/tutorials/)
- [Examples Gallery](https://krish567366.github.io/Quantum-Langchain/examples/)
## 🧪 Examples
Check out our comprehensive examples in the `/examples` directory:
- **Basic Quantum Reasoning**: `examples/basic_quantum_chain.ipynb`
- **Memory Entanglement**: `examples/quantum_memory_demo.ipynb`
- **Multi-Agent Systems**: `examples/entangled_agents.ipynb`
- **Quantum Retrieval**: `examples/quantum_rag_system.ipynb`
- **Timeline Manipulation**: `examples/temporal_reasoning.ipynb`
## 🧬 Architecture
QuantumLangChain follows a modular, extensible architecture:
```bash
quantumlangchain/
├── core/ # Core quantum-classical interfaces
├── chains/ # QLChain implementations
├── memory/ # Quantum memory systems
├── agents/ # Entangled agent frameworks
├── tools/ # Quantum tool executors
├── retrievers/ # Quantum-enhanced retrieval
├── backends/ # Quantum backend abstractions
├── vectorstores/ # Hybrid vector databases
└── utils/ # Utility functions and helpers
```
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
### Development Setup
```bash
git clone https://github.com/krish567366/Quantum-Langchain.git
cd Quantum-Langchain
pip install -e .[dev]
pre-commit install
```
### Running Tests
```bash
pytest tests/
```
### Code Formatting
```bash
black quantumlangchain/
ruff check quantumlangchain/
```
## 📊 Performance Benchmarks
| Operation | Classical Time | Quantum-Enhanced Time | Speedup |
|-----------|---------------|----------------------|---------|
| Semantic Search | 150ms | 45ms | 3.3x |
| Multi-Agent Reasoning | 800ms | 320ms | 2.5x |
| Memory Retrieval | 100ms | 35ms | 2.9x |
| Chain Execution | 500ms | 200ms | 2.5x |
### *Benchmarks run on quantum simulators with 16 qubits*
## 🔮 Roadmap
- [ ] **Q1 2025**: Hardware quantum backend integration
- [ ] **Q2 2025**: Advanced error correction protocols
- [ ] **Q3 2025**: Quantum neural network support
- [ ] **Q4 2025**: Distributed quantum computing
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- Inspired by LangChain's composable AI architecture
- Built on the shoulders of giants in quantum computing
- Special thanks to the quantum computing research community
## 📞 Contact
### **Krishna Bajpai**
- Email: [bajpaikrishna715@gmail.com](mailto:bajpaikrishna715@gmail.com)
- GitHub: [@krish567366](https://github.com/krish567366)
- Project: [Quantum-Langchain](https://github.com/krish567366/Quantum-Langchain)
---
**"Bridging the quantum-classical divide in artificial intelligence"** 🌉⚛️🤖
Raw data
{
"_id": null,
"home_page": null,
"name": "quantumlangchain",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Krishna Bajpai <bajpaikrishna715@gmail.com>",
"keywords": "quantum, langchain, ai, quantum-computing, agents, memory, entanglement, licensed, commercial",
"author": null,
"author_email": "Krishna Bajpai <bajpaikrishna715@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/fe/ff/620d7443f7c04dec4203203fbd9378fb96dd860d5221095cb5b63d6c1011/quantumlangchain-1.1.1.tar.gz",
"platform": null,
"description": "# \ud83e\uddec QuantumLangChain\r\n<p align=\"center\">\r\n <img src=\"./assests/quantum-langchain.png\" alt=\"QuantumLangChain Logo\" width=\"180\"/>\r\n</p>\r\n\r\n\r\n[](https://www.python.org/downloads/)\r\n[](#-licensing)\r\n[](https://krish567366.github.io/Quantum-Langchain)\r\n[](https://github.com/psf/black)\r\n\r\n**LICENSED SOFTWARE: A composable framework for quantum-inspired reasoning, entangled memory systems, and multi-agent cooperation \u2014 engineered for next-gen artificial intelligence.**\r\n\r\n**\ud83d\udce7 Contact: bajpaikrishna715@gmail.com for licensing** \r\n**\u23f0 24-hour grace period available for evaluation**\r\n\r\n---\r\n\r\n## Licensing\r\n\r\n**\u26a0\ufe0f IMPORTANT: QuantumLangChain is commercial software requiring a valid license for all features beyond the 24-hour evaluation period.**\r\n\r\n### Quick Start with Licensing\r\n\r\n1. **Install**: `pip install quantumlangchain`\r\n2. **Import**: Automatically starts 24-hour evaluation\r\n3. **Get Machine ID**: `python -c \"import quantumlangchain; print(quantumlangchain.get_machine_id())\"`\r\n4. **Contact**: Email [bajpaikrishna715@gmail.com](mailto:bajpaikrishna715@gmail.com) with your machine ID\r\n5. **Activate**: Receive and activate your license file\r\n\r\n## \ud83e\uddec About QuantumLangChain\r\n\r\nQuantumLangChain bridges the gap between classical AI and quantum computing, providing a unified framework for building hybrid quantum-classical AI systems with advanced memory management, multi-agent cooperation, and quantum-inspired reasoning capabilities.\r\n\r\n## \ud83d\ude80 Features\r\n\r\n### \ud83d\udd27 Core Modules\r\n\r\n- **QLChain**: Quantum-ready chains with decoherence-aware control flows and circuit injection\r\n- **QuantumMemory**: Reversible, entangled memory layers with hybrid vector store support\r\n- **QuantumToolExecutor**: Tool execution router with quantum-classical API bridge\r\n- **EntangledAgents**: Multi-agent systems with shared memory entanglement and interference-based reasoning\r\n- **QPromptChain**: Prompt chaining with quantum-style uncertainty branching\r\n- **QuantumRetriever**: Quantum-enhanced semantic retrieval using Grover-based subquery refinement\r\n- **QuantumContextManager**: Temporal snapshots and dynamic context expansion\r\n\r\n### \ud83e\uddec Advanced Capabilities\r\n\r\n- **Decoherence-Aware Reasoning**: Simulate quantum noise impact on logic and decision trees\r\n- **Timeline Rewriting**: Memory snapshotting, branching, and rollback of reasoning paths\r\n- **Entangled Collaboration**: Agents with shared belief states and quantum-style communication\r\n- **Self-Adaptive Reasoning Graphs**: Dynamic agent chain restructuring during execution\r\n\r\n## \ud83d\udce6 Installation\r\n\r\n### Basic Installation\r\n\r\n```bash\r\npip install quantumlangchain\r\n```\r\n\r\n### Development Installation\r\n\r\n```bash\r\npip install quantumlangchain[dev]\r\n```\r\n\r\n### Full Installation (with all optional dependencies)\r\n\r\n```bash\r\npip install quantumlangchain[all]\r\n```\r\n\r\n### From Source\r\n\r\n```bash\r\ngit clone https://github.com/krish567366/Quantum-Langchain.git\r\ncd Quantum-Langchain\r\npip install -e .\r\n```\r\n\r\n## \ud83e\udde0 Quick Start\r\n\r\n### Basic Quantum Chain\r\n\r\n```python\r\nfrom quantumlangchain import QLChain, QuantumMemory\r\nfrom quantumlangchain.backends import QiskitBackend\r\n\r\n# Initialize quantum backend\r\nbackend = QiskitBackend()\r\n\r\n# Create quantum memory\r\nmemory = QuantumMemory(\r\n classical_dim=512,\r\n quantum_dim=8,\r\n backend=backend\r\n)\r\n\r\n# Build a quantum chain\r\nchain = QLChain(\r\n memory=memory,\r\n decoherence_threshold=0.1,\r\n circuit_depth=10\r\n)\r\n\r\n# Execute with quantum-classical hybrid reasoning\r\nresult = await chain.arun(\"Analyze the quantum implications of this dataset\")\r\n```\r\n\r\n### Multi-Agent Entanglement\r\n\r\n```python\r\nfrom quantumlangchain import EntangledAgents, SharedQuantumMemory\r\n\r\n# Create shared quantum memory\r\nshared_memory = SharedQuantumMemory(agents=3, entanglement_depth=4)\r\n\r\n# Initialize entangled agents\r\nagents = EntangledAgents(\r\n agent_count=3,\r\n shared_memory=shared_memory,\r\n interference_weight=0.3\r\n)\r\n\r\n# Collaborative quantum reasoning\r\nresults = await agents.collaborative_solve(\r\n \"Complex multi-dimensional optimization problem\"\r\n)\r\n```\r\n\r\n### Quantum-Enhanced Retrieval\r\n\r\n```python\r\nfrom quantumlangchain import QuantumRetriever\r\nfrom quantumlangchain.vectorstores import HybridChromaDB\r\n\r\n# Setup hybrid vector store\r\nvectorstore = HybridChromaDB(\r\n classical_embeddings=True,\r\n quantum_embeddings=True,\r\n entanglement_degree=2\r\n)\r\n\r\n# Quantum retriever with Grover enhancement\r\nretriever = QuantumRetriever(\r\n vectorstore=vectorstore,\r\n grover_iterations=3,\r\n quantum_speedup=True\r\n)\r\n\r\n# Enhanced semantic search\r\ndocs = await retriever.aretrieve(\"quantum machine learning applications\")\r\n```\r\n\r\n## \ud83d\udee0\ufe0f Supported Quantum Backends\r\n\r\n- **Qiskit**: IBM Quantum platform integration\r\n- **PennyLane**: Differentiable quantum programming\r\n- **Amazon Braket**: AWS quantum computing service\r\n- **Cirq**: Google's quantum computing framework\r\n- **Qulacs**: High-performance quantum simulator\r\n\r\n## \ud83d\udcda Documentation\r\n\r\nComprehensive documentation is available at [krish567366.github.io/Quantum-Langchain](https://krish567366.github.io/Quantum-Langchain)\r\n\r\n### Key Sections\r\n\r\n- [Getting Started Guide](https://krish567366.github.io/Quantum-Langchain/getting-started/)\r\n- [API Reference](https://krish567366.github.io/Quantum-Langchain/api/)\r\n- [Quantum Concepts](https://krish567366.github.io/Quantum-Langchain/concepts/)\r\n- [Integration Tutorials](https://krish567366.github.io/Quantum-Langchain/tutorials/)\r\n- [Examples Gallery](https://krish567366.github.io/Quantum-Langchain/examples/)\r\n\r\n## \ud83e\uddea Examples\r\n\r\nCheck out our comprehensive examples in the `/examples` directory:\r\n\r\n- **Basic Quantum Reasoning**: `examples/basic_quantum_chain.ipynb`\r\n- **Memory Entanglement**: `examples/quantum_memory_demo.ipynb`\r\n- **Multi-Agent Systems**: `examples/entangled_agents.ipynb`\r\n- **Quantum Retrieval**: `examples/quantum_rag_system.ipynb`\r\n- **Timeline Manipulation**: `examples/temporal_reasoning.ipynb`\r\n\r\n## \ud83e\uddec Architecture\r\n\r\nQuantumLangChain follows a modular, extensible architecture:\r\n\r\n```bash\r\nquantumlangchain/\r\n\u251c\u2500\u2500 core/ # Core quantum-classical interfaces\r\n\u251c\u2500\u2500 chains/ # QLChain implementations\r\n\u251c\u2500\u2500 memory/ # Quantum memory systems\r\n\u251c\u2500\u2500 agents/ # Entangled agent frameworks\r\n\u251c\u2500\u2500 tools/ # Quantum tool executors\r\n\u251c\u2500\u2500 retrievers/ # Quantum-enhanced retrieval\r\n\u251c\u2500\u2500 backends/ # Quantum backend abstractions\r\n\u251c\u2500\u2500 vectorstores/ # Hybrid vector databases\r\n\u2514\u2500\u2500 utils/ # Utility functions and helpers\r\n```\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\r\n\r\n### Development Setup\r\n\r\n```bash\r\ngit clone https://github.com/krish567366/Quantum-Langchain.git\r\ncd Quantum-Langchain\r\npip install -e .[dev]\r\npre-commit install\r\n```\r\n\r\n### Running Tests\r\n\r\n```bash\r\npytest tests/\r\n```\r\n\r\n### Code Formatting\r\n\r\n```bash\r\nblack quantumlangchain/\r\nruff check quantumlangchain/\r\n```\r\n\r\n## \ud83d\udcca Performance Benchmarks\r\n\r\n| Operation | Classical Time | Quantum-Enhanced Time | Speedup |\r\n|-----------|---------------|----------------------|---------|\r\n| Semantic Search | 150ms | 45ms | 3.3x |\r\n| Multi-Agent Reasoning | 800ms | 320ms | 2.5x |\r\n| Memory Retrieval | 100ms | 35ms | 2.9x |\r\n| Chain Execution | 500ms | 200ms | 2.5x |\r\n\r\n### *Benchmarks run on quantum simulators with 16 qubits*\r\n\r\n## \ud83d\udd2e Roadmap\r\n\r\n- [ ] **Q1 2025**: Hardware quantum backend integration\r\n- [ ] **Q2 2025**: Advanced error correction protocols\r\n- [ ] **Q3 2025**: Quantum neural network support\r\n- [ ] **Q4 2025**: Distributed quantum computing\r\n\r\n## \ud83d\udcc4 License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## \ud83d\ude4f Acknowledgments\r\n\r\n- Inspired by LangChain's composable AI architecture\r\n- Built on the shoulders of giants in quantum computing\r\n- Special thanks to the quantum computing research community\r\n\r\n## \ud83d\udcde Contact\r\n\r\n### **Krishna Bajpai**\r\n\r\n- Email: [bajpaikrishna715@gmail.com](mailto:bajpaikrishna715@gmail.com)\r\n- GitHub: [@krish567366](https://github.com/krish567366)\r\n- Project: [Quantum-Langchain](https://github.com/krish567366/Quantum-Langchain)\r\n\r\n---\r\n\r\n**\"Bridging the quantum-classical divide in artificial intelligence\"** \ud83c\udf09\u269b\ufe0f\ud83e\udd16\r\n",
"bugtrack_url": null,
"license": "Commercial License",
"summary": "LICENSED: A composable framework for quantum-inspired reasoning, entangled memory systems, and multi-agent cooperation",
"version": "1.1.1",
"project_urls": {
"Documentation": "https://krish567366.github.io/Quantum-Langchain",
"Homepage": "https://github.com/krish567366/Quantum-Langchain",
"Issues": "https://github.com/krish567366/Quantum-Langchain/issues",
"Repository": "https://github.com/krish567366/Quantum-Langchain"
},
"split_keywords": [
"quantum",
" langchain",
" ai",
" quantum-computing",
" agents",
" memory",
" entanglement",
" licensed",
" commercial"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "60f36360dc3bf97ad062529dfedc5a15f29867f9f52b1f61b732c1f9f8dc7b47",
"md5": "a677a59114f0d1d2a635fc893dc4afd7",
"sha256": "bfcbb125efad3adc602d6774e4a798b4236ede88888082bd184b8d02f07abef0"
},
"downloads": -1,
"filename": "quantumlangchain-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a677a59114f0d1d2a635fc893dc4afd7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 86504,
"upload_time": "2025-07-19T16:52:32",
"upload_time_iso_8601": "2025-07-19T16:52:32.969448Z",
"url": "https://files.pythonhosted.org/packages/60/f3/6360dc3bf97ad062529dfedc5a15f29867f9f52b1f61b732c1f9f8dc7b47/quantumlangchain-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "feff620d7443f7c04dec4203203fbd9378fb96dd860d5221095cb5b63d6c1011",
"md5": "cd70de553eeee5ed9ceeb8f428e0dc49",
"sha256": "40cf40b8bc9a7290bac82e67adde93cb648e18cd1e55c1f9c2dd785d5db2a828"
},
"downloads": -1,
"filename": "quantumlangchain-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "cd70de553eeee5ed9ceeb8f428e0dc49",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 85356,
"upload_time": "2025-07-19T16:52:39",
"upload_time_iso_8601": "2025-07-19T16:52:39.556357Z",
"url": "https://files.pythonhosted.org/packages/fe/ff/620d7443f7c04dec4203203fbd9378fb96dd860d5221095cb5b63d6c1011/quantumlangchain-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-19 16:52:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "krish567366",
"github_project": "Quantum-Langchain",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "quantumlangchain"
}
JSON
