CleanSync-AI

A developer built CleanSync.ai, an open-source, fully local security airlock that intercepts files downloaded from browsers, messaging apps, and cloud storage into an isolated staging folder before they reach primary storage. The tool uses a local Llama 3.2 model served through Ollama to inspect file code and logic for malware, scripts, and hacker payloads without uploading private files to third-party servers, then either moves verified files to secure storage or pops up a Tkinter GUI warning offering the user the choice to allow or quarantine the file. It relies on Python 3.8+, Ollama, the openai, watchfiles, python-dotenv, and tkinter libraries, plus a virtual environment and adjusted PowerShell execution policy on Windows.

1.Problem statement - When downloading files from web browsers like Google Chrome, messaging apps, or any cloud storage into a laptop, files are written directly into active local storage while connected to live networks. If a downloaded file contains a HIDDEN VIRUS, BUGS, MALICIOUS SCRIPT, or HACKER PAYLOAD such as zero-day logic exploits, reverse shells, or credential exfiltration vectors , it can instantly infect the operating system, steal sensitive personal data like PASSWORDS and DOCUMENTS , or give hackers remote control of the computer. Traditional antivirus software relies mostly on old signature matching, allowing new zero-day threats, obfuscated scripts, and sneaky hacker tools hidden inside ordinary files to slip through unnoticed. Furthermore, online cloud AI security scanners compromise user privacy by uploading confidential personal files to external third-party servers over the internet. There is a critical need for an open-source, 100% local, privacy-first security airlock running directly on the user's laptop that acts as an intermediate staging buffer—intercepting incoming network downloads offline, auditing file syntax and code logic using local LLMs via Ollama without exposing private data to the internet, detecting bugs, viruses, and hacker threats, and prompting the user with an on-screen graphical GUI warning before allowing any file onto primary local storage. 2.Solution statement - Modularization or Code Refactoring is used in CleanSync.ai. it is a modular, open-source security airlock that runs 100% locally on your laptop. It acts as an intermediate staging buffer between web downloads and your primary computer storage. Instead of letting downloaded files write directly to your hard drive, it automatically catches them in a safe, isolated holding folder. Operating entirely offline right on your machine, CleanSync.ai uses a local open-source AI model Llama 3.2 via Ollama to deeply inspect the file's code and logic for bugs, viruses, and hacker threats without sending your private files anywhere else. If a file is verified as safe, it is quietly moved to secure storage. If a threat is detected, an interactive on-screen warning window pops up right on your screen, giving you the final choice to either allow the file or lock it away safely in quarantine. 3.Here is the complete list of prerequisites needed to run CleanSync.ai locally on your computer: 3.1. Software & Engines Python Version 3.8 or higher : The core programming language used to run the background script. Ollama: The local software engine installed on your computer to host and run open-source AI models completely offline. Local AI Model llama3.2 : Downloaded via Ollama ollama pull llama3.2 so the system has an offline AI brain to inspect file code and logic. 3.2. Required Python Libraries These libraries power the background file monitoring, AI communication, environment settings, and graphical pop-up alerts: openai: Connects the Python script to your local Ollama AI model. watchfiles: Monitors your laptop's live Downloads folder for new incoming files. python-dotenv: Reads your configuration settings securely from a .env file. tkinter: Python's built-in GUI library used to pop up the on-screen Allow / Quarantine warning windows. 3.3. System Configuration PowerShell Execution Policy: Adjusted on Windows Set-ExecutionPolicy RemoteSigned -Scope CurrentUser to allow virtual environment activation and script execution. Virtual Environment venv : An isolated workspace inside your project folder to manage and store all project dependencies cleanly.