π Top 10 Finalist - Hackcrux LNMIIT 2024 | 800+ National Teams
A privacy-first AI desktop assistant that works completely offline, automating your daily tasks without compromising your data.
Features β’ Installation β’ Usage β’ Demo β’ Contributing
SyncFlow is a revolutionary offline AI assistant designed for privacy-conscious users who want powerful automation without sacrificing data security. Unlike cloud-based assistants, SyncFlow processes everything locally on your machine.
- Privacy Concerns: Cloud-based AI assistants send your data to external servers
- Internet Dependency: Most assistants require constant internet connectivity
- Limited Automation: Existing tools lack comprehensive task automation capabilities
- Data Security: Sensitive information at risk with third-party services
SyncFlow provides a completely offline AI experience with advanced automation capabilities, ensuring 100% data privacy while delivering enterprise-grade productivity features.
- β 100% Offline Processing - No data ever leaves your machine
- β Zero Cloud Dependencies - Works without internet connection
- β Local Data Storage - All information stays on your device
- β Encrypted Communications - End-to-end security for all operations
- π§ Smart Email Management - Automatic summarization, categorization, and responses
- π Intelligent Scheduling - Context-aware calendar management and reminders
- π Browser Automation - Seamless web interaction and data extraction
- π Task Optimization - 60% reduction in manual task completion time
- β‘ High Performance - Optimized for local processing
- π§ Cross-Platform - Supports Windows, macOS, and Linux
- π¨ User-Friendly Interface - Intuitive desktop application
- π Extensible Architecture - Plugin system for custom automations
graph TD
A[User Interface] --> B[SyncFlow Core Engine]
B --> C[LangChain Processing]
B --> D[Selenium Automation]
B --> E[Local AI Models]
C --> F[Email Handler]
C --> G[Schedule Manager]
D --> H[Browser Controller]
D --> I[Web Scraper]
E --> J[Natural Language Processing]
E --> K[Task Classification]
F --> L[Local Storage]
G --> L
H --> L
I --> L
- Python 3.8 or higher
- 4GB RAM minimum (8GB recommended)
- 2GB free disk space
# Clone the repository
git clone https://github.com/yourusername/syncflow.git
cd syncflow
# Create virtual environment
python -m venv syncflow_env
source syncflow_env/bin/activate # On Windows: syncflow_env\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Download required AI models (one-time setup)
python setup_models.py
# Run SyncFlow
python main.pyπ Detailed Setup Instructions
Ubuntu/Debian:
sudo apt update
sudo apt install python3-dev python3-pip chromium-browsermacOS:
brew install python@3.9 chromiumWindows:
# Install Python from python.org
# Download Chrome/Edge browser- Create configuration file:
cp config/config.example.yaml config/config.yaml- Customize settings:
# config/config.yaml
ai_model:
model_path: "models/local_llm"
max_tokens: 2048
automation:
email_check_interval: 300 # seconds
browser_timeout: 30
privacy:
data_retention_days: 30
encryption_enabled: truefrom syncflow import BrowserAutomation
# Create browser automation
browser = BrowserAutomation(
headless=True,
timeout=30,
user_agent='custom'
)
# Automate daily tasks
browser.automate_task([
"navigate_to('https://dashboard.example.com')",
"extract_data('.metrics-table')",
"generate_report(template='daily_summary')"
])| Metric | Before SyncFlow | With SyncFlow | Improvement |
|---|---|---|---|
| Email Processing Time | 45 min/day | 18 min/day | 60% Reduction |
| Task Automation | Manual | Automated | 100% Automation |
| Data Privacy Risk | High (Cloud) | Zero (Local) | Complete Security |
| Internet Dependency | Required | Optional | Offline Capable |
- β No Data Collection - We don't collect any user data
- β Local Processing - All AI operations run on your device
- β Encrypted Storage - All data encrypted with AES-256
- β No Telemetry - Zero tracking or analytics
- π‘οΈ Sandboxed Execution - Isolated runtime environment
- π Secure Communications - TLS encryption for all network requests
- π Access Controls - User-defined permission system
- π¨ Audit Logging - Complete activity logging for transparency
- Backend: Python 3.8+, LangChain, asyncio
- Automation: Selenium WebDriver, BeautifulSoup
- AI/ML: Transformers, scikit-learn, NLTK
- UI: Tkinter/PyQt (Desktop), FastAPI (Web Interface)
- Storage: SQLite, JSON, encrypted files
syncflow/
βββ src/
β βββ core/ # Core AI engine
β βββ automation/ # Task automation modules
β βββ ui/ # User interface
β βββ utils/ # Utilities and helpers
βββ models/ # Local AI models
βββ config/ # Configuration files
βββ tests/ # Test suite
βββ docs/ # Documentation
We welcome contributions! Please see our Contributing Guide for details.
# Fork the repository
# Create feature branch
git checkout -b feature/amazing-feature
# Make changes and commit
git commit -m "Add amazing feature"
# Push and create pull request
git push origin feature/amazing-feature- Placement: Top 10 among 800+ national teams
- Recognition: Best Privacy-Focused Solution
- Innovation Award: Outstanding AI Implementation
- 50+ Beta Users actively using the system
- 60% Time Reduction in daily task completion
- 100% Data Privacy compliance achieved
- Zero Security Incidents since deployment
This project is licensed under the MIT License - see the LICENSE file for details.
| Role | Contributor |
|---|---|
| Lead Developer | Sagar Kumar Sahu |
| AI Engineer | Aritra Mahanty |
| Security Architect | Shreyas Desai |
| UI/UX Designer | Aryan Mishra |
Please create an issue with detailed information:
- OS and Python version
- Steps to reproduce
- Expected vs actual behavior
- Error logs (if any)
We love new ideas! Open an issue with:
- Description of the feature
- Use case and benefits
- Implementation suggestions
- Email: lone124wolf@gmail.com
Built with β€οΈ for Privacy-Conscious Users