EntangleMe

Quantum teleportation messaging app simulating qubit transfer with Qiskit and interactive web UI.

Quick Start & Getting Started

Getting EntangleMe running locally takes two steps:

git clone https://github.com/Luxion-Labs/EntangleMe.git
cd EntangleMe
pip install -r requirements.txt

Launch the simulation backend:

uvicorn main:app --reload --port 8000

Live Demo

• Frontend Application: https://entangleme.vercel.app/
• Backend API: https://entangleme.onrender.com/
• API Documentation: https://entangleme.onrender.com/docs

Tech Stack

Documentation

** Core Documentation**

• Complete Project Documentation - Overview and setup guide
• System Architecture & Implementation - Detailed technical architecture
• ️ Quantum Implementation Guide - Quantum computing implementation details
• Quantum Simulation Proof - Proof of real quantum implementation
• Quantum Visualization System - Frontend quantum visualization components
• Quantum Circuit Diagrams - Detailed circuit diagrams and explanations

Production Deployment

Backend (Render)

• Deployed: https://entangleme.onrender.com/
• Status: Active and running

HOST=0.0.0.0
PORT=8000
DEBUG=False
SECRET_KEY=your-super-secret-key
DATABASE_URL=your-database-url
REDIS_URL=your-redis-url

VITE_API_URL=https://entangleme.onrender.com/api/v1

️ Core Concept

EntangleMe follows actual quantum teleportation principles:

Entangle → Encode → Measure → Send Classical Bits → Apply Corrections

Why EntangleMe Matters?

1. Quantum-Resistant Messaging

By transforming our simulated teleportation pipeline into a true QKD channel, EntangleMe can use the randomly generated measurement outcomes as shared secret keys. After each teleportation, those key bits encrypt classical payloads - guaranteeing that any eavesdropping attempt is immediately detectable.

️ We Also Used: Classiq to Auto-Generate Teleportation Circuits

To simplify or scale the quantum backend, we explored using Classiq, a high-level quantum algorithm synthesis platform. Instead of building the quantum circuit manually, Classiq lets us define intent, and it builds the optimized circuit for us.

Features

** Core Features**

• ️ Real Quantum Teleportation: Actual Qiskit quantum circuits for teleportation
• Secure Communication: Quantum-based security principles
• Real-time Chat: Instant messaging with quantum state transmission
• Interactive Visualization: Quantum circuit diagrams and state evolution
• Bell Pair Entanglement: Real quantum entanglement simulation
• Success Probability: Quantum measurement outcome analysis

Project Structure

EntangleMe/
├──  backend/                 # FastAPI backend
│   ├──  app/
│   │   ├──  api/            # API endpoints
│   │   ├──  core/           # Configuration
│   │   ├──  database/       # Database layer
│   │   ├──  models/         # Data models
│   │   ├──  schemas/        # Pydantic schemas
│   │   ├──  services/       # Business logic
│   │   └── main.py           # FastAPI app
│   ├── requirements.txt       # Python dependencies
│   └── run.py               # Entry point

<details>
<summary><b>Expand **Project Structure** Details</b></summary>
<br/>

├──  frontend/               # React frontend
│   ├──  src/
│   │   ├──  components/     # React components
│   │   ├──  api/           # API client
│   │   ├──  types/         # TypeScript types
│   │   └── main.tsx         # React app
│   ├── package.json          # Node.js dependencies
│   └── vite.config.ts       # Vite configuration

├──  docs/                  # Project documentation
│   ├──  EntangleMe.md     # System architecture
│   ├──  QUANTUM_*.md      # Quantum implementation docs
│   ├──  CLASSIQ_*.md      # Quantum hardware setup
│   └──  docs.md           # Overview documentation
├──  README.md             # This file
├──  SETUP.md              # Setup guide
└──  LICENSE               # MIT License

‍ Team Members

External Links

• Prototype Website: https://entangleme.vercel.app/
• Demo Video: https://youtu.be/0y06cFS6Wwo
• Devpost Project: https://devpost.com/software/entangleme
• Hackathon: https://cqhack25.devpost.com/

Resources

Quantum Computing

• Qiskit Teleportation Notebook
• ▶️ Qiskit YouTube Tutorial
• ️ Classiq Documentation
• IBM Quantum Lab

Maintainer Response SLA

Luxion Labs enforces a strict 24-hour response SLA on all community issues, feature proposals, and pull requests. See CONTRIBUTING.md for full development guidelines.