{"id":28330485,"url":"https://github.com/amaansyed27/sentinel","last_synced_at":"2026-03-05T06:33:14.438Z","repository":{"id":290251035,"uuid":"973787522","full_name":"amaansyed27/Sentinel","owner":"amaansyed27","description":"A next-generation web security browser extension with AI-powered analysis, created for the HackHazards 25 hackathon.","archived":false,"fork":false,"pushed_at":"2025-05-19T07:53:26.000Z","size":3025,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-03T03:12:51.977Z","etag":null,"topics":["cybersecurity","extension","groq-api","hackathon","hackathon-project","hackhazard","hackhazards-2025","hackhazards-25","html-css-javascript","node","screenpipe","top100","web","web-development","web-extension","webpack","webpack-plugin","webpack5","website"],"latest_commit_sha":null,"homepage":"https://sentinel-cyber.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amaansyed27.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-27T18:29:37.000Z","updated_at":"2025-05-30T08:41:27.000Z","dependencies_parsed_at":"2025-04-27T20:45:37.641Z","dependency_job_id":null,"html_url":"https://github.com/amaansyed27/Sentinel","commit_stats":null,"previous_names":["amaansyed27/sentinel"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/amaansyed27/Sentinel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amaansyed27%2FSentinel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amaansyed27%2FSentinel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amaansyed27%2FSentinel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amaansyed27%2FSentinel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amaansyed27","download_url":"https://codeload.github.com/amaansyed27/Sentinel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amaansyed27%2FSentinel/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260643559,"owners_count":23041104,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","extension","groq-api","hackathon","hackathon-project","hackhazard","hackhazards-2025","hackhazards-25","html-css-javascript","node","screenpipe","top100","web","web-development","web-extension","webpack","webpack-plugin","webpack5","website"],"created_at":"2025-05-26T16:53:39.314Z","updated_at":"2026-03-05T06:33:14.398Z","avatar_url":"https://github.com/amaansyed27.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛡️ Sentinel MK2\r\n\r\n![HackHazards Submission Banner](site/images/hackhazards-banner.png)\r\n\r\n[![Hackathon Project](https://img.shields.io/badge/Hackathon-HackHazards%2025-blueviolet)](https://sentinel-cyber.vercel.app)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\r\n[![Demo Video](https://img.shields.io/badge/Demo-YouTube-red)](https://youtu.be/U0GpWONDVRU)\r\n\r\n\u003e **Sentinel MK2** is a next-gen browser extension for **real-time web security**, built with **AI-powered analysis** and visual indicators to enhance your online safety—developed during **HackHazards 25**, where it ranked in the **Top 100 projects** out of **8000+ submissions** from **17500+ participants**, representing **25+ countries** and **30+ universities**.\r\n\r\n---\r\n\r\n## 🌐 Live Project\r\n\r\n* 🔗 **Website**: [sentinel-cyber.vercel.app](https://sentinel-cyber.vercel.app)\r\n* 🎥 **Demo Video**: [Watch on YouTube](https://youtu.be/U0GpWONDVRU)\r\n* 📄 **Privacy Policy**: [View Here](https://sentinel-cyber.vercel.app/privacy.html)\r\n\r\n---\r\n\r\n## 🌟 Key Features\r\n\r\n* **🔒 Real-Time Security Scoring**: Instantly assess the security of any website you visit\r\n* **🔐 SSL/TLS Certificate Insights**: View detailed certificate verification for HTTPS connections\r\n* **🤖 AI Security Chat**: Ask AI-powered questions about the current site’s safety using the Groq API\r\n* **🧭 Link Security Markers**: Get visual cues on link safety before clicking\r\n* **🖥️ Screen Content Analysis** *(via Screenpipe)*: Detect potential phishing or risky content on-screen\r\n\r\n---\r\n\r\n## 🧰 Tech Stack\r\n\r\n* **Chrome Extension APIs** — For deep browser integration\r\n* **Groq API (LLaMA 3 70B)** — Powers the AI assistant\r\n* **Screenpipe** — Enables real-time screen analysis\r\n* **JavaScript + Webpack** — Core logic and bundling\r\n\r\n---\r\n\r\n## ⚙️ Installation Guide\r\n\r\n### 🔗 Browser Extension Setup\r\n\r\n1. **Download**:\r\n\r\n   * Grab the unpacked extension from [Download Page](https://sentinel-cyber.vercel.app/download.html) or use the `dist` folder.\r\n\r\n2. **Load in Chrome**:\r\n\r\n   * Visit `chrome://extensions/`\r\n   * Enable *Developer Mode*\r\n   * Click **Load unpacked** and select the extension folder\r\n\r\n3. **API Key Setup**:\r\n\r\n   * Get your free Groq API key from [Groq Console](https://console.groq.com)\r\n   * Open the extension → Settings → Paste your API key\r\n\r\n4. ✅ You’re all set! The extension is now active.\r\n\r\n### 🖥️ Screenpipe Setup *(Optional)*\r\n\r\n1. Open PowerShell or CMD\r\n2. Run:\r\n\r\n   ```sh\r\n   iwr get.screenpi.pe/cli.ps1 | iex\r\n   screenpipe.exe\r\n   ```\r\n3. Keep this running in the background when using screen analysis features\r\n\r\n---\r\n\r\n## 🎯 Hackathon Purpose\r\n\r\nSentinel MK2 was built for **HackHazards 25**, a cybersecurity-focused hackathon. The goal:\r\n\r\n\u003e Empower users to **proactively identify and understand** security threats through a browser-native, AI-integrated tool.\r\n\r\n### Project Highlights:\r\n\r\n* Contextual AI explanations for non-technical users\r\n* Proactive phishing and fake-site detection\r\n* Real-time, privacy-first assessments\r\n\r\n---\r\n\r\n## 🤝 Contributing\r\n\r\nWant to help improve Sentinel MK2? Follow these steps:\r\n\r\n```bash\r\n# Fork \u0026 clone the repo\r\ngit checkout -b feature-name\r\n# Make your changes\r\ngit commit -m \"Describe your changes\"\r\ngit push origin feature-name\r\n# Open a pull request!\r\n```\r\n\r\n---\r\n\r\n## 📄 License\r\n\r\nMIT License – see [LICENSE](LICENSE)\r\n\r\n---\r\n\r\n\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"https://sentinel-cyber.vercel.app\"\u003e\r\n    \u003cimg src=\"site/images/sentinel-logo.png\" alt=\"Sentinel Logo\" width=\"80\" height=\"80\"\u003e\r\n  \u003c/a\u003e\r\n  \u003cbr\u003e\r\n  \u003ci\u003eCreated for HackHazards 25 – A project by Amaan Syed\u003cbr\u003e\r\n  🏅 Top 100 Project | Among 8000+ projects | 17500+ participants\u003c/i\u003e\r\n\u003c/p\u003e\r\n\r\n---\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famaansyed27%2Fsentinel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famaansyed27%2Fsentinel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famaansyed27%2Fsentinel/lists"}