{"id":23288537,"url":"https://github.com/KernFerm/Survival-Guide-UE","last_synced_at":"2025-08-21T19:31:44.490Z","repository":{"id":259274491,"uuid":"877433857","full_name":"KernFerm/Survival-Guide-Ultimate-Edition","owner":"KernFerm","description":"A flexible Survival Guide with tools and strategies for wilderness survival, apocalyptic events, disasters, and more. Covers fire-starting, shelter-building, foraging, water, navigation, and emergency response.","archived":false,"fork":false,"pushed_at":"2024-12-06T07:37:06.000Z","size":48,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-06T08:18:16.329Z","etag":null,"topics":["apocalyptic-survival","disaster-preparedness","emergency-response","fire-starting","food-rationing","navigation","outdoor-skills","python","shelter-building","survival-guide","survival-strategies","survival-tools","water-purification","wilderness-preparation"],"latest_commit_sha":null,"homepage":"","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/KernFerm.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-23T16:35:00.000Z","updated_at":"2024-12-06T07:37:10.000Z","dependencies_parsed_at":"2024-12-06T08:18:07.494Z","dependency_job_id":"b1922436-3310-4eeb-bffa-e4e2bd7378fb","html_url":"https://github.com/KernFerm/Survival-Guide-Ultimate-Edition","commit_stats":null,"previous_names":["kernferm/survival-guide-ultimate-edition"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FSurvival-Guide-Ultimate-Edition","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FSurvival-Guide-Ultimate-Edition/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FSurvival-Guide-Ultimate-Edition/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FSurvival-Guide-Ultimate-Edition/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KernFerm","download_url":"https://codeload.github.com/KernFerm/Survival-Guide-Ultimate-Edition/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230528050,"owners_count":18240091,"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":["apocalyptic-survival","disaster-preparedness","emergency-response","fire-starting","food-rationing","navigation","outdoor-skills","python","shelter-building","survival-guide","survival-strategies","survival-tools","water-purification","wilderness-preparation"],"created_at":"2024-12-20T03:20:34.456Z","updated_at":"2025-08-21T19:31:44.481Z","avatar_url":"https://github.com/KernFerm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Survival Guide in Python 🏞️🛠️\r\n\r\n## Overview\r\n\r\nThis comprehensive **Survival Guide** equips you with the tools, techniques, and strategies to survive in various challenging scenarios, including wilderness survival, apocalyptic events, world disasters, and grid-down situations. It includes modules for fire-starting, shelter-building, food foraging, water procurement, navigation, and emergency response. The guide is designed to be flexible, allowing users to modify it for their specific survival needs.\r\n\r\n---\r\n\r\n- [https://discord.gg/FxJd3PxXbc](https://discord.gg/FxJd3PxXbc)\r\n\r\n### Project Structure\r\n\r\n```\r\nsurvival_guide/\r\n│\r\n├── survival_tools/\r\n│   ├── __init__.py (package initialization)\r\n│   ├── fire_tools.py (fire-starting techniques for all environments)\r\n│   ├── shelter_tools.py (shelter-building techniques across various climates)\r\n│   ├── food_tools.py (foraging, hunting, and food preservation methods)\r\n│   ├── water_tools.py (locating, purifying, and rationing water)\r\n│   ├── navigation_tools.py (compass, sun, star navigation, and signaling)\r\n│   ├── apocalypse_tools.py (apocalyptic survival tools, defense, and bartering)\r\n│   ├── nature_resources.py (using nature as a resource in survival situations)\r\n│   ├── emergency_response.py (emergency response for disasters and grid-down scenarios)\r\n│   ├── water_tracker.py (water and food consumption tracker with rationing)\r\n│\r\n├── install_python.bat (python 3.11.6 installer batchfile)\r\n├── main.py (main entry point to access all survival tools)\r\n├── README.md (this guide)\r\n└── requirements.txt (lists Python dependencies)\r\n└── run.bat (installed the dependencies)\r\n```\r\n\r\n\r\n---\r\n\r\n## Features\r\n\r\n- **Fire Starting Techniques** 🔥  \r\n  Learn to start a fire using tools and nature-based methods:\r\n  - Flint and Steel\r\n  - Bow Drill\r\n  - Fire Plough\r\n  - Solar Ignition\r\n  - Natural Tinder (dry leaves, grass, bark)\r\n  - Char Cloth and Fungus for fire-starting\r\n\r\n- **Shelter Building** 🏕️  \r\n  Find out how to build shelters using:\r\n  - Branches for framework\r\n  - Leaves for insulation\r\n  - Rocks for protection\r\n  - Mud for sealing gaps\r\n  - Snow for igloos and snow caves\r\n  - Tarp for quick shelter setup\r\n\r\n- **Foraging and Hunting** 🍃🐟  \r\n  Gather food through foraging, trapping, and fishing:\r\n  - Berries, edible plants, mushrooms (with caution)\r\n  - Small animal traps (e.g., snares, deadfall traps)\r\n  - Fishing in rivers, lakes, and streams\r\n  - Long-term food storage (drying, smoking, salting)\r\n\r\n- **Water Procurement and Purification** 💧  \r\n  Learn to find and purify water using:\r\n  - Streams, rivers, and rainwater collection\r\n  - Solar stills, dew collection, and transpiration bags\r\n  - Boiling, solar disinfection, chemical purification, filtration\r\n\r\n- **Navigation Tools** 🧭  \r\n  Navigate using:\r\n  - Compass\r\n  - Sun and Shadows for direction\r\n  - Star Navigation (North Star, constellations)\r\n  - Moss on trees for natural navigation\r\n  - Signaling methods for rescue (smoke signals, reflective surfaces)\r\n\r\n- **Apocalyptic Survival Tools** 🛡️  \r\n  Survive in long-term apocalyptic scenarios with:\r\n  - Makeshift weapons (spears, slingshots, Molotov cocktails)\r\n  - Fortifying shelters using natural barriers and traps\r\n  - Bartering for essential goods (food, water, medicine)\r\n  - Creating defensive perimeters with noise-making alarms\r\n\r\n- **Using Nature as a Resource** 🌿  \r\n  Discover how nature can help you survive:\r\n  - Tree sap as adhesive and fire starter\r\n  - Plant fibers for cordage (ropes, snares, shelter construction)\r\n  - Stone tools for cutting and scraping\r\n  - Natural insulation (leaves, grass, moss)\r\n  - Water extraction from plants (cacti, vines)\r\n\r\n- **Emergency Response Strategies** 🚨  \r\n  Prepare for world events and natural disasters:\r\n  - Earthquakes, floods, wildfires, hurricanes, and tsunamis\r\n  - Grid-down scenarios (prepare bug-out bags, communication plans)\r\n  - Pandemic isolation and quarantine techniques\r\n\r\n- **Water and Food Rationing** 🥤🍲  \r\n  Manage your resources using the advanced water and food tracker:\r\n  - Track daily consumption of water and food\r\n  - Calculate rations based on remaining resources and days left\r\n  - Visualize consumption with charts for water and food\r\n  - Ration recommendations for specific environments (arctic, desert, rainforest)\r\n\r\n---\r\n\r\n### Use the `install_python.bat` to install python 3.11.9\r\n\r\n\r\n---\r\n\r\n## Installation\r\n\r\n1. Clone the repository or download the project files:\r\n```\r\ngit clone https://github.com/KernFerm/Survival-Guide-UE.git\r\n```\r\n\r\n2. **Create a virtual environment (optional but recommended):**\r\n\r\n```\r\npython -m venv venv\r\n```\r\n\r\n3. **Activate the virtual environment:**\r\n\r\n- ***On Windows:***\r\n\r\n```\r\nvenv\\Scripts\\activate\r\n```\r\n\r\n4. **Install the required dependencies:**\r\n\r\n```\r\npip install -r requirements.txt\r\n```\r\n- or use the `run.bat` to install the dependencies.\r\n\r\n## How to Use the Project\r\n\r\n1. **Run the Project\r\n- Run the main script to start using the survival tools:\r\n\r\n```\r\npython main.py\r\n```\r\n\r\n2. **Choose a Module**\r\n\r\nFollow the on-screen prompts to select which survival tool you want to explore, whether it's fire-starting, shelter-building, food gathering, or water procurement.\r\n\r\n3. **Water and Food Tracking**\r\n\r\nUse the water tracker to manage your water and food supplies. You can track your consumption and receive daily ration recommendations based on the days you need to survive:\r\n\r\n```\r\npython water_tracker.py\r\n```\r\n\r\n4. **Customize the Guide**\r\n\r\nYou can modify any of the modules to better suit your personal needs or the environment you expect to encounter:\r\n\r\n- **Change fire-starting techniques** in `fire_tools.py` to reflect the resources available in your region.\r\n\r\n- **New survival strategies** for `arctic`, `desert`, or `rainforest` conditions.\r\n\r\n- **New emergency response plans** for specific disasters.\r\n\r\n## Water and Food Consumption Tracker\r\n\r\nThe water and food tracker helps you manage your consumption and rationing during survival situations. After consuming water or food, a pie chart will display the remaining resources. You can also receive daily ration recommendations based on your needs.\r\n\r\n### Example Usage:\r\n\r\n- Start by setting how much water and food you have available:\r\n\r\n```\r\npython water_tracker.py\r\n```\r\n\r\n- Visualize water and food consumption with charts to plan your resources better.\r\n\r\n## Customizing for Your Needs\r\n\r\nYou can easily edit the survival guide to best suit your needs. Here’s how:\r\n\r\n- **Change Region-Specific Techniques:**\r\nIf you're planning for a specific location (e.g., desert survival), edit the files in `survival_tools/` to reflect that environment.\r\n\r\n- **Add Your Own Emergency Responses:**\r\nModify `emergency_response.py` to include disaster preparedness strategies for events more common in your area, such as hurricanes or tornadoes.\r\n\r\n- **Modify Water and Food Rationing:**\r\nUpdate `water_tracker.py` to customize how much water or food is needed for your daily rations, based on personal or family needs.\r\n\r\n## License\r\n\r\n***This project is open-source and available for anyone to use. Contributions are welcome! Feel free to fork the repository, improve the project, or submit a pull request.***\r\n\r\n## Credits\r\n\r\nDeveloped by `Bubbles The Dev`, dedicated to providing accessible survival knowledge for everyone. 🌍🌱\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKernFerm%2FSurvival-Guide-UE","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FKernFerm%2FSurvival-Guide-UE","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKernFerm%2FSurvival-Guide-UE/lists"}