{"id":18084165,"url":"https://github.com/bonelesswater/ibm-hackathon","last_synced_at":"2025-08-01T23:43:20.591Z","repository":{"id":259809695,"uuid":"878682549","full_name":"BonelessWater/IBM-Hackathon","owner":"BonelessWater","description":"ByteStorm is a Django web app that provides prevention and assistance during natural disasters. The platform offers guidelines and essential help to those in need before, during, and after natural disasters.","archived":false,"fork":false,"pushed_at":"2024-10-27T19:08:54.000Z","size":1752,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-17T07:28:45.060Z","etag":null,"topics":["azure","css","django","google","html","https","javascript","material-ui","materializecss","python","smtp","web"],"latest_commit_sha":null,"homepage":"https://bytestorm.azurewebsites.net","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/BonelessWater.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-10-25T21:13:13.000Z","updated_at":"2024-10-28T00:24:53.000Z","dependencies_parsed_at":"2024-10-28T05:15:56.169Z","dependency_job_id":"7f506b86-3fab-4b10-b9ff-cce16bf3936c","html_url":"https://github.com/BonelessWater/IBM-Hackathon","commit_stats":null,"previous_names":["bonelesswater/ibm-hackathon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BonelessWater/IBM-Hackathon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BonelessWater%2FIBM-Hackathon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BonelessWater%2FIBM-Hackathon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BonelessWater%2FIBM-Hackathon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BonelessWater%2FIBM-Hackathon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BonelessWater","download_url":"https://codeload.github.com/BonelessWater/IBM-Hackathon/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BonelessWater%2FIBM-Hackathon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268314676,"owners_count":24231031,"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","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["azure","css","django","google","html","https","javascript","material-ui","materializecss","python","smtp","web"],"created_at":"2024-10-31T15:05:55.024Z","updated_at":"2025-08-01T23:43:20.538Z","avatar_url":"https://github.com/BonelessWater.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ByteStorm - Disaster Prevention and Assistance Web App\n\n## Overview\n\nByteStorm is a Django web app that provides prevention and assistance during natural disasters. The platform offers guidelines and essential help to those in need before, during, and after natural disasters. ByteStorm helps users prepare for emergencies, locate critical resources, and connect with others who are willing to offer help.\n\n## Features\n\n- **Prevention Guidelines**: Offers AI-driven predictive tips on reducing risks and preparing for potential natural disasters. This includes creating emergency kits, knowing evacuation routes, securing homes, and staying informed.\n- **Emergency Resources**: Provides information on essential emergency resources such as shelters, hospitals, and gas stations. Users can quickly find the nearest available help when disaster strikes. Resource information is updated regularly to ensure accuracy.\n- **Community Assistance Matching**: Matches people in need with those who are offering assistance, allowing for community-driven support during difficult times. Matching is based on location and specific needs.\n- **Real-Time Alerts and ByteBot Chat**: Users can interact with ByteBot, an integrated chatbot that provides real-time information and answers to frequently asked questions about natural disasters.\n\n## Technology Stack\n\n- **Backend**: Django (Python)\n- **Frontend**: HTML, CSS, JavaScript (Materialize CSS framework for design)\n- **Chatbot**: Integrated using JavaScript to facilitate real-time interactions\n\n## Installation\n\nTo get started with ByteStorm, follow these steps:\n\n1. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/username/bytestorm.git\n   cd bytestorm\n   ```\n\n2. **Create a Virtual Environment**:\n   ```bash\n   python -m venv venv\n   ```\n\n3. **Activate the Virtual Environment**:\n   - On Windows:\n     ```bash\n     venv\\Scripts\\activate\n     ```\n   - On macOS/Linux:\n     ```bash\n     source venv/bin/activate\n     ```\n\n4. **Install Dependencies**:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n5. **Run Migrations**:\n   ```bash\n   python manage.py migrate\n   ```\n\n6. **Start the Development Server**:\n   ```bash\n   python manage.py runserver\n   ```\n\n7. **Access the Web App**:\n   Open your web browser and navigate to `http://127.0.0.1:8000/`.\n\n## Usage\n\nOnce the server is running, you can use ByteStorm to:\n\n- **Prepare for Disasters**: Access detailed prevention guidelines to help minimize risks.\n- **Locate Emergency Resources**: Use the resource finder to get real-time information on shelters, hospitals, and gas stations nearby.\n- **Get Assistance**: Connect with other users who are offering assistance.\n- **Chat with ByteBot**: Use the integrated chatbot to get immediate answers to your questions.\n\n## Contribution\n\nWe welcome contributions to improve ByteStorm. To contribute:\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature-branch`).\n3. Make your changes and commit them (`git commit -m 'Add new feature'`).\n4. Push to the branch (`git push origin feature-branch`).\n5. Open a pull request.\n\nBefore contributing, please review the existing issues to avoid redundancy.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. The MIT License is a permissive license that allows for reuse with few restrictions, making it ideal for open-source projects.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonelesswater%2Fibm-hackathon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbonelesswater%2Fibm-hackathon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonelesswater%2Fibm-hackathon/lists"}