{"id":22116149,"url":"https://github.com/blacksujit/suraksha","last_synced_at":"2025-03-24T05:30:43.238Z","repository":{"id":252432920,"uuid":"840396495","full_name":"Blacksujit/Suraksha","owner":"Blacksujit","description":"Welcome to the **SURAKSHA -- Secure Document Query Application**! This powerful tool allows you to securely upload, search, and analyze documents with ease. Built using Streamlit, this app offers an intuitive interface and various features for managing your document queries efficiently.","archived":false,"fork":false,"pushed_at":"2024-08-12T18:33:47.000Z","size":15618,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T11:22:44.653Z","etag":null,"topics":["aspect-oriented-programming","cloud","community-cloud-patterns","dashboard","database-design","databse","document","implemeation","integration","model-checking","model-selection","parser","project","queries-database","queries-keeper","repository-pattern","search","secure-document","streamlit-webapp","testing-tools"],"latest_commit_sha":null,"homepage":"https://suraksha.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Blacksujit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-08-09T15:58:54.000Z","updated_at":"2024-11-15T07:46:53.000Z","dependencies_parsed_at":"2024-12-01T12:29:39.758Z","dependency_job_id":null,"html_url":"https://github.com/Blacksujit/Suraksha","commit_stats":null,"previous_names":["blacksujit/suraksha_-secure_locker-","blacksujit/suraksha"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blacksujit%2FSuraksha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blacksujit%2FSuraksha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blacksujit%2FSuraksha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Blacksujit%2FSuraksha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Blacksujit","download_url":"https://codeload.github.com/Blacksujit/Suraksha/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245216385,"owners_count":20579149,"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":["aspect-oriented-programming","cloud","community-cloud-patterns","dashboard","database-design","databse","document","implemeation","integration","model-checking","model-selection","parser","project","queries-database","queries-keeper","repository-pattern","search","secure-document","streamlit-webapp","testing-tools"],"created_at":"2024-12-01T12:19:36.434Z","updated_at":"2025-03-24T05:30:43.190Z","avatar_url":"https://github.com/Blacksujit.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📄 **SURAKSHA -- Secure Document Query Application**\n\nWelcome to the **SURAKSHA -- Secure Document Query Application**! This powerful tool allows you to securely upload, search, and analyze documents with ease. Built using Streamlit, this app offers an intuitive interface and various features for managing your document queries efficiently.\n\n## 🕸️🕸️📲 [Live WebApp](https://suraksha.streamlit.app/)\n\n## 📂 Folder Structure:\n\nHere is the folder structure of the project:\n\n```\nsecure-document-query-app/\n│\n├── main.py                # Main entry point of the Streamlit application\n├── requirements.txt       # List of Python dependencies\n│----data/\n|       sample_data\n|\n├── utils/\n│   ├── __init__.py        # Initialize the utils package\n│   ├── db.py              # Database functions (setup, queries, etc.)\n│   |── document_parser.py # Functions for parsing documents\n│   |--security.py\n|   |--test_fernet.py\n|\n├──  queries.db\n|---- secure_db.sqlite\n|-----security.key\n│\n└── README.md              # This README file\n\n```\n\n\n## 🌟 **Web App Demo**\n\n[App Demo](recording.mp4) -- click to download Video of web app \n\n_A visual representation of the app's working interface_\n\n\n## Screenshots Of Web App:\n\n\n![alt text](\u003cScreenshot 2024-08-09 213208.png\u003e)\n\n\n![alt text](image.png)\n\n\n![alt text](\u003cimage copy.png\u003e)\n\n\n![alt text](newimg.png)\n\n\n\n## 🚀 **Features**\n\n- **🔒 Secure Document Upload**: Upload and store your documents securely.\n- **🔍 Advanced Search**: Perform keyword-based searches within your documents.\n- **📊 Dashboard**: View insightful metrics and visualizations about your documents and search activities.\n  - **Document Count**: Track the number of documents you have uploaded.\n  - **Most Searched Queries**: Analyze the most frequently searched queries.\n  - **Document Type Distribution**: Visualize the distribution of different document types.\n  - **Search Trends**: Observe trends in search activities over time.\n  - **Word Cloud**: Explore common terms found in your documents with a visually appealing word cloud.\n- **💾 Download History**: Download your chat and search history for record-keeping.\n\n## 🛠️ **Getting Started**\n\nTo get started with the **Secure Document Query Application**, follow these steps:\n\n\n## Installation:\n\n\n### 1. **Clone the Repository**\n\n```bash\ngit clone  https://github.com/Blacksujit/SURAKSHA_-Secure_Locker-.git\n\n```\n\n### **Set Up the Virtual Environment**:\n\n```\npython -m venv venv\n\n```\n```\nsource venv/bin/activate   # On Windows, use `venv\\Scripts\\activate`\n```\n\n### **Install Dependencies**:\n\n```\npip install -r requirements.txt\n\n```\n\n### **Run the Application**:\n\n```\nstreamlit run main.py\n\n```\n\n## 📋 How It Works:\n\n\n1.) Upload Document: Use the sidebar to upload PDF, DOCX, or TXT files. The text from the document is parsed and saved securely.\n\n2.) Search Queries: Enter search queries and click \"Search\" to find relevant results in your documents. The search queries and results are saved for analysis.\n\n3.) Dashboard: Navigate to the Dashboard to view various metrics and visualizations, including document count, most searched queries, document type distribution, search trends, and a word cloud of common terms.\nDownload History: Download your chat history from the sidebar for offline access.\n\n## 🎨 Visual Enhancements:\n\nThe application features a clean and modern UI with:\n\n \n1.) Interactive Charts: Dynamic and responsive charts for better data visualization.\n\n2.) Word Cloud: A visually appealing representation of common terms.\n\n## 🛠️ Technology Stack\n\n1.) Python necessary (❤️)\n\n2.) Streamlit: Framework for building interactive web applications.\n\n3.) Matplotlib \u0026 Seaborn: Libraries for creating charts and graphs.\n\n4.) Pandas: Data manipulation and analysis.\n\n5.) WordCloud: For generating word clouds.\n\n6.) SQLite: Lightweight database for storing document and query data.\n\n\n## 🔗 Links:\n\n1.) Streamlit Community Cloud - [Platform for deploying Streamlit apps.](https://share.streamlit.io/deploy?repository=Blacksujit%2FSURAKSHA_-Secure_Locker-\u0026branch=main\u0026mainModule=main.py)\n\n2.) GitHub Repository -  https://github.com/Blacksujit/SURAKSHA_-Secure_Locker-.git\n\n## 💬 Feedback \u0026 Contributions:\n\nWe welcome feedback and contributions! If you encounter any issues or have suggestions, please open an issue or pull request on our GitHub repository.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblacksujit%2Fsuraksha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblacksujit%2Fsuraksha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblacksujit%2Fsuraksha/lists"}