Skip to content

Aman071106/Nyxara

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

35 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌌 Nyxara

Your Digital Night Guardian

Nyxara Banner

Flutter TypeScript Python MongoDB

Nyxara is a comprehensive Flutter WebApp that serves as your digital security guardian, detecting data breaches using the XposedOrNot API and providing AI-powered security assistance. Named after Nyx (goddess of night) and Ara (defense/guard), Nyxara watches over your digital presence in the vast darkness of cyberspace.

πŸ“– Documentation | 🀝 Contributing | πŸ›‘οΈ Security


✨ Features

πŸ” Breach Detection & Monitoring

  • Real-time Breach Scanning - Powered by XposedOrNot API
  • Email Compromise Detection - Instant alerts for compromised accounts
  • Historical Breach Analysis - Track your digital footprint over time
  • Smart Notifications - Get notified of new breaches affecting your accounts

πŸ€– AI-Powered Security Assistant

  • Breach Advisor Agent - Powered by Llama-3.3-70b-versatile via Groq API
  • Personalized Security Recommendations - Tailored advice based on your risk profile
  • Threat Intelligence - AI-driven insights on emerging security threats
  • Interactive Security Guidance - Chat with your AI security consultant

πŸ” Advanced Vault Management

  • Encrypted Password Storage - Military-grade encryption for your credentials
  • Cross-Platform Synchronization - Access your vault anywhere, anytime
  • Secure Sharing - Share credentials safely with team members
  • Automatic Backup - Never lose your important data

πŸ”’ Enterprise-Grade Security

  • Two-Factor Authentication (2FA) - Enhanced account protection
  • Google OAuth Integration - Seamless and secure authentication
  • Email OTP Verification - SMTP-based security verification
  • End-to-End Encryption - Your data is always protected

πŸ“Š Beautiful Data Visualization

  • Interactive Charts - Powered by Syncfusion Flutter Charts
  • 3D Security Metrics - Immersive data presentation with O3D
  • Real-time Dashboards - Monitor your security posture at a glance
  • Custom Reports - Generate detailed security analysis reports

πŸ—οΈ Architecture

Clean Architecture with BLoC Pattern

πŸ›οΈ PRESENTATION LAYER (UI)
    ↓
🧠 BUSINESS LOGIC LAYER (BLoC)
    ↓
βš™οΈ USE CASES LAYER
    ↓
πŸ—‚οΈ DOMAIN REPOSITORY INTERFACE
    ↓
πŸ’Ύ DATA REPOSITORY IMPLEMENTATION
    ↓
🌐 DATA SOURCES (API/Database)

Multi-Tier Backend Architecture

  • Authentication Service - TypeScript + MongoDB (NoSQL)
  • Vault Management - SQL with Cryptography
  • AI Advisory Service - Python + Groq API
  • Email Service - SMTP with App Passwords

πŸ› οΈ Tech Stack

Frontend

  • Flutter Web - Cross-platform web application
  • BLoC Pattern - Predictable state management
  • Go Router - Declarative routing solution
  • Syncfusion Charts - Professional data visualization
  • O3D Engine - 3D graphics and animations

Backend Services

  • TypeScript + Node.js - Authentication microservice
  • Python + FastAPI - AI advisory service
  • MongoDB - User authentication data
  • PostgreSQL - Encrypted vault storage
  • Render - Cloud deployment platform

Security & Encryption

  • bcrypt - Password hashing
  • Cryptography - Data encryption
  • JWT Tokens - Secure authentication
  • SMTP OTP - Email verification

AI & Intelligence

  • Groq API - High-performance AI inference
  • Llama-3.3-70b - Advanced language model
  • XposedOrNot API - Breach detection service

πŸš€ Quick Start

Prerequisites

  • Flutter SDK (^3.7.2)
  • Node.js (16+ recommended)
  • Python (3.8+ recommended)
  • MongoDB instance
  • PostgreSQL database

Installation

  1. Clone the Repository

    git clone https://github.com/Aman071106/nyxara.git
    cd nyxara
  2. Setup Flutter App

    flutter pub get
    cp assets/.env.example assets/.env
    # Configure your environment variables
  3. Setup Backend Services

    # TypeScript Auth Service
    cd backend
    npm install
    npm run build
    
    # Python AI Service
    cd src/ai_agents
    pip install -r requirements.txt
  4. Configure Environment Variables

    # API Keys
    GROQ_API_KEY=your_groq_api_key
    
    # Database
    MONGODB_URI=your_mongodb_connection_string
    POSTGRES_URI=your_postgres_connection_string
    
    # Email Service
    EMAIL_USER=[email protected]
    EMAIL_APP_PASSWORD=your_app_password
  5. Launch the Application

    flutter run -d chrome

πŸ”’ Security Architecture

Data Protection

  • AES-256 Encryption - Industry-standard encryption for sensitive data
  • Salt & Hash - bcrypt with custom salt for password security
  • Zero-Knowledge Architecture - We never see your unencrypted data
  • Secure Transmission - All data encrypted in transit with TLS 1.3

Authentication Flow

graph TD
    A[User Login] --> B{Auth Method?}
    B -->|Email/Password| C[bcrypt Verification]
    B -->|Google OAuth| D[OAuth Validation]
    C --> E[Generate JWT]
    D --> E
    E --> F[2FA Challenge]
    F --> G[Email OTP]
    G --> H[Access Granted]
Loading

Vault Security Model

  • Client-Side Encryption - Data encrypted before leaving your device
  • Key Derivation - PBKDF2 with 100,000 iterations
  • Secure Storage - Encrypted database with row-level security
  • Access Control - Multi-factor authentication required

πŸ“± Key Features Deep Dive

Breach Detection Engine

Our advanced breach detection system continuously monitors multiple data sources:

  • Real-time API Integration with XposedOrNot
  • Historical Breach Database with 10+ billion compromised accounts
  • Custom Alert System with intelligent notification filtering
  • Breach Impact Assessment with AI-powered risk analysis

AI Security Advisor

Powered by cutting-edge AI technology:

  • Groq API Integration for lightning-fast responses
  • Llama-3.3-70b Model for sophisticated security analysis
  • Contextual Recommendations based on your specific security profile
  • Proactive Threat Intelligence to stay ahead of emerging risks

Vault Management System

Enterprise-grade password management:

  • Zero-Knowledge Architecture - We never see your passwords
  • Cross-Device Synchronization with end-to-end encryption
  • Secure Password Generation with customizable complexity
  • Breach-Aware Updates - Automatic alerts for compromised passwords

🎨 User Interface

Modern Design Philosophy

  • Dark Mode First - Easy on the eyes during long security sessions
  • Responsive Design - Seamless experience across all devices
  • Intuitive Navigation - Clean, security-focused interface
  • Accessibility - WCAG 2.1 AA compliant

3D Visualizations

  • Interactive Security Metrics - Engaging 3D charts and graphs
  • Threat Landscape Visualization - See your security posture in 3D
  • Animated Breach Indicators - Real-time visual alerts
  • Immersive Dashboard Experience - Next-generation security UI

πŸ”§ Development Setup

Development Guidelines

  • Clean Architecture - Separation of concerns with clear boundaries
  • BLoC Pattern - Predictable state management across the app
  • Test-Driven Development - Comprehensive unit and integration tests
  • Code Quality - Lint rules and formatting standards enforced

πŸš€ Deployment

Flutter Web Deployment

The application is optimized for web deployment with:

  • Progressive Web App (PWA) capabilities
  • Service Worker for offline functionality
  • Optimized Bundle Size with tree-shaking
  • CDN Integration for global performance

Backend Deployment on Render

# render.yaml
services:
  - type: web
    name: nyxara-backend
    env: node
    plan: free
    buildCommand: npm run build
    startCommand: npm start
    rootDir: backend

Environment-Specific Configurations

  • Development - Local databases and API keys
  • Staging - Testing environment with sanitized data
  • Production - Fully encrypted with monitoring and alerts

πŸ§ͺ Testing Strategy

Comprehensive Test Coverage

  • Unit Tests - Individual component and function testing
  • Integration Tests - Feature interaction testing
  • Widget Tests - UI component behavior verification
  • End-to-End Tests - Complete user journey validation

Security Testing

  • Penetration Testing - Regular security audits
  • Vulnerability Scanning - Automated security assessments
  • Compliance Verification - GDPR and security standard adherence

🌟 Roadmap

Phase 1: Core Security βœ…

  • Basic breach detection
  • Secure authentication
  • Password vault
  • AI security advisor

Phase 2: Advanced Features 🚧

  • Real-time breach monitoring
  • Team collaboration features
  • Advanced threat intelligence
  • Mobile app versions

Phase 3: Enterprise πŸ“‹

  • Enterprise SSO integration
  • Advanced compliance reporting
  • API for third-party integrations
  • Custom security policies

Phase 4: AI Evolution πŸ€–

  • Predictive breach analysis
  • Automated security responses
  • Custom AI model training
  • Advanced behavioral analytics

🀝 Contributing

We welcome contributions from security enthusiasts and developers! Here's how you can help:

Ways to Contribute

  • πŸ› Bug Reports - Help us identify and fix issues
  • ✨ Feature Requests - Suggest new security features
  • πŸ”§ Code Contributions - Submit pull requests
  • πŸ“š Documentation - Improve our guides and tutorials
  • πŸ§ͺ Testing - Help us maintain quality standards

Contribution Guidelines

  1. Fork the Repository and create your feature branch
  2. Follow Coding Standards - Use our linting and formatting rules
  3. Write Tests - Ensure your code is well-tested
  4. Update Documentation - Keep README and docs current
  5. Submit Pull Request - Provide clear description of changes

Development Environment

# Setup development environment
git clone https://github.com/Aman071106/nyxara.git
cd nyxara
flutter pub get
flutter test  # Run tests
flutter analyze  # Check code quality

πŸ“„ License

MIT License - We believe in open-source security tools.

MIT License

Copyright (c) 2024 Nyxara

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

πŸ™ Acknowledgments

Special thanks to:

  • XposedOrNot - For providing the breach detection API
  • Groq - For high-performance AI inference
  • Flutter Team - For the amazing cross-platform framework
  • Security Community - For continuous feedback and contributions
  • Open Source Contributors - Making digital security accessible to all

Made with πŸ’™ by developers who care about your digital security

Nyxara - Because your digital safety should never sleep

GitHub Stars


"In the darkness of cyberspace, Nyxara stands guard" πŸŒ™πŸ›‘οΈ

About

Flutter WebApp for detecting data breach and providing ai powered assistance

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published