How geetheshwar420/projectageis works
AGIES is a browser-heavy, post-quantum secure messaging product with a Flask real-time relay and Firebase persistence. The main workflow is identity setup and key publication, friend/chat discovery, client-side message encryption, relay and offline delivery, then local history and decryption. The graph also preserves the documented identity, file, and cryptographic capabilities. Evidence is limited to the README, excerpts, and SOURCE INDEX references; unsampled runtime wiring is not assumed.
Main entry points: App.tsx App orchestration · api.ts HTTP client · AuthContext.tsx Authentication · ChatWindow.tsx Chat window
Components 23
Browser client
- App orchestration
frontend/App.tsx - Authentication
frontend/context/AuthContext.tsx - Chat window
frontend/components/ChatWindow.tsx - Friend discovery
frontend/components/LeftSidebar.tsx - Profile and sharing
frontend/components/QRCodeModal.tsx - File handling
frontend/services/FileService.ts - Socket connection
frontend/context/SocketContext.tsx - HTTP client
frontend/services/api.ts
Cryptography
- Client crypto engine
frontend/services/CryptoEngine.ts - Quantum service
backend/crypto/quantum_service.py - BB84 protocol
backend/crypto/bb84.py - Kyber KEM
backend/crypto/kyber.py - Dilithium signatures
backend/crypto/dilithium.py - Crypto models
backend/crypto/crypto_models.py
Relay backend
- Flask app
backend/app.py - HTTP routes
backend/routes.py - Socket events
backend/socket_events.py
Persistence and identity
- Local vault
frontend/services/StorageService.ts - Google identity
frontend/services/firebase.ts - Database access
backend/db.py - Firebase storage
backend/firebase_db.py
Other components
- User
- Firestore
Connections 32
- User → App orchestration: uses
- App orchestration → Authentication: wraps
frontend/App.tsx - App orchestration → Chat window: renders
frontend/App.tsx - App orchestration → Friend discovery: renders
frontend/App.tsx - App orchestration → Profile and sharing: renders
frontend/App.tsx - App orchestration → HTTP client: fetches data
frontend/App.tsx - App orchestration → Local vault: loads history
frontend/App.tsx - App orchestration → Client crypto engine: decrypts history
frontend/App.tsx - Authentication → HTTP client: authenticates
frontend/context/AuthContext.tsx - Authentication → Client crypto engine: creates keys
frontend/context/AuthContext.tsx - Authentication → Local vault: stores keys
frontend/context/AuthContext.tsx - Authentication → Google identity: signs in
frontend/context/AuthContext.tsx - Chat window → Client crypto engine: encrypts messages
frontend/components/ChatWindow.tsx - Chat window → Local vault: stores messages
frontend/components/ChatWindow.tsx - Chat window → HTTP client: requests data
frontend/components/ChatWindow.tsx - Chat window → Socket connection: uses socket
frontend/components/ChatWindow.tsx - Friend discovery → HTTP client: searches peers
frontend/components/LeftSidebar.tsx - File handling → HTTP client: uploads files
frontend/services/FileService.ts - Socket connection → Flask app: relays events
- HTTP client → Flask app: sends requests
- Flask app → HTTP routes: registers routes
backend/app.py - Flask app → Socket events: registers handlers
backend/app.py - HTTP routes → Database access: queries
backend/routes.py - Socket events → Database access: updates status
backend/socket_events.py - Database access → Firebase storage: delegates
backend/db.py - Firebase storage → Firestore: persists metadata
- Firebase storage → Firestore: queues messages
- Google identity → HTTP routes: provides identity token
- Quantum service → BB84 protocol: uses protocol
backend/crypto/quantum_service.py - Quantum service → Kyber KEM: uses KEM
backend/crypto/quantum_service.py - Quantum service → Dilithium signatures: uses signatures
backend/crypto/quantum_service.py - Quantum service → Crypto models: uses models
backend/crypto/quantum_service.py