A comprehensive privacy protection platform that automatically scans, monitors, and cleans up your digital footprint across social media and data brokers.
- Intelligent Privacy Scanning: NLP-powered detection of sensitive information
- Automated Social Media Cleanup: Twitter, Facebook, Instagram, LinkedIn integration
- Data Broker Opt-out: Automated removal requests
- Privacy Score & Gamification: Track your privacy improvements
- Real-time Monitoring: Scheduled privacy audits
- Modern Web Interface: Cutting-edge landing page with glassmorphism design and chat-based interaction
privai/
├── backend/ # Python backend with AI agent
├── frontend/ # React web application
├── desktop/ # Electron desktop app
├── shared/ # Shared types and utilities
└── infrastructure/ # Docker, deployment configs
# Clone the repository
git clone <repository-url>
cd privai
# Copy environment file
cp .env.example .env
# Start all services
docker-compose up -d
# Open http://localhost:3000# Clone the repository
git clone <repository-url>
cd privai
# Install all dependencies
npm run install:all
# Set up environment
cp .env.example .env
# Edit .env with your API keys
# Start PostgreSQL and Redis locally
# Then start development servers
npm run dev
# Open http://localhost:3000The application is built with a modern microservices architecture:
- Backend API: FastAPI with async support
- Privacy Agent: AI-powered decision engine
- Task Queue: Celery with Redis for background jobs
- Database: PostgreSQL with SQLAlchemy ORM
- Frontend: React with TypeScript and Tailwind CSS
- Real-time Updates: WebSocket support for live monitoring
- NLP-powered sensitive data detection
- Real-time privacy score calculation
- Multi-platform social media analysis
- AI-driven decision making
- Automated cleanup actions
- Personalized recommendations
- Real-time privacy score tracking
- Gamification with badges and achievements
- Historical trend analysis
- Scheduled privacy audits
- Alert system for privacy breaches
- Continuous improvement suggestions
- Backend: Python, FastAPI, SQLAlchemy, Celery
- Frontend: React 18, TypeScript, Tailwind CSS, Framer Motion, Glassmorphism Design
- Desktop: Electron
- Database: PostgreSQL
- Cache/Queue: Redis
- AI/ML: spaCy, transformers, OpenAI API
- Infrastructure: Docker, Docker Compose
POST /api/v1/chat- Chat with privacy agentPOST /api/v1/analyze- Analyze text for privacy risks
GET /api/v1/privacy-score/{user_id}- Get privacy scorePOST /api/v1/start-monitoring/{user_id}- Start automated monitoring
POST /api/v1/social/connect- Connect social accountsPOST /api/v1/social/cleanup- Clean up social mediaGET /api/v1/social/status- Get cleanup status
Key environment variables (see .env.example):
DATABASE_URL- PostgreSQL connection stringREDIS_URL- Redis connection stringSECRET_KEY- JWT signing keyOPENAI_API_KEY- OpenAI API key for enhanced AI features- Social media API keys (Twitter, Facebook, LinkedIn)
# Backend tests
cd backend && pytest
# Frontend tests
cd frontend && npm test
# Or run all tests
npm run test# Linting
npm run lint
# Type checking
cd frontend && npm run type-check
cd backend && mypy .# Build production images
docker-compose -f docker-compose.prod.yml build
# Deploy
docker-compose -f docker-compose.prod.yml up -dThe application is cloud-ready with:
- Health checks for all services
- Horizontal scaling support
- Environment-based configuration
- Monitoring and logging hooks
- Data Encryption: All sensitive data encrypted at rest
- API Security: JWT authentication with refresh tokens
- Privacy by Design: Minimal data collection
- Open Source: Fully auditable codebase
- Local First: Can run entirely offline
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request
- GPT-4 integration for smarter recommendations
- Image analysis for visual privacy risks
- Voice analysis for audio content
- Browser extension
- Mobile app (React Native)
- Slack/Discord bots
- Team/organization accounts
- Compliance reporting (GDPR, CCPA)
- Advanced analytics dashboard
MIT License - see LICENSE file for details.
- 📧 Email: support@privai.com
- 💬 Discord: Join our community
- 📖 Documentation: docs.privai.com
- 🐛 Issues: GitHub Issues