{"id":18347449,"url":"https://github.com/katanabana/holidroute","last_synced_at":"2026-01-05T07:05:48.809Z","repository":{"id":236442545,"uuid":"792389422","full_name":"katanabana/HolidRoute","owner":"katanabana","description":"A web app created for TulaHack 2024, case 7 (\"Маршрут Выходного Дня\" от ТЕЛЕ2) . This web app is used to find nearby places based on user preferences. Tech: React, Python, Geoapify, g4f, ymaps","archived":false,"fork":false,"pushed_at":"2024-09-17T10:03:19.000Z","size":16155,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-21T21:11:25.352Z","etag":null,"topics":["g4f","geoapify","geolocation","map-api","places-near-me","python","react","tele2","tulahack","tulahack2024","user-preferences","weekend-travel","ymaps"],"latest_commit_sha":null,"homepage":"https://holidroute.netlify.app","language":"JavaScript","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/katanabana.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-04-26T15:11:44.000Z","updated_at":"2024-09-17T10:03:22.000Z","dependencies_parsed_at":"2024-04-27T06:21:23.628Z","dependency_job_id":"c974b503-ae20-42dc-852b-98406b332597","html_url":"https://github.com/katanabana/HolidRoute","commit_stats":null,"previous_names":["katanabana/holidroute"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katanabana%2FHolidRoute","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katanabana%2FHolidRoute/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katanabana%2FHolidRoute/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/katanabana%2FHolidRoute/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/katanabana","download_url":"https://codeload.github.com/katanabana/HolidRoute/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247463743,"owners_count":20942935,"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":["g4f","geoapify","geolocation","map-api","places-near-me","python","react","tele2","tulahack","tulahack2024","user-preferences","weekend-travel","ymaps"],"created_at":"2024-11-05T21:14:06.037Z","updated_at":"2026-01-05T07:05:48.742Z","avatar_url":"https://github.com/katanabana.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HolidRoute\n\nThis project is a web application that allows users to enter their route preferences, and based on their location, it\nfinds nearby places using the Geoapify API. The relevant places are filtered using g4f to match the user's preferences\nand are displayed on a map. Users can also explore different transportation options.\n\n![HolidRoute Demo](demo.gif)\n\nURL of the published version: https://holidroute.netlify.app\n\n### About this Project\n\nThis application was developed during TulaHack 2024, case 7 (\"Маршрут Выходного Дня\" от ТЕЛЕ2) \n\n\n## Table of Contents\n\n- [Features](#features)\n- [Tech Stack](#tech-stack)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Running the Application](#running-the-application)\n- [Environment Variables](#environment-variables)\n\n## Features\n\n- Enter route preferences to find relevant nearby places.\n- Display places on an interactive map.\n- Filter places using g4f to fit user preferences.\n- Explore different transportation options.\n\n## Tech Stack\n\n- **Frontend:** React.js\n- **Backend:** Python (FastAPI)\n- **APIs:** Geoapify, g4f\n- **Map Integration:** ymaps (used in the React component)\n\n## Prerequisites\n\nMake sure you have the following installed on your local machine:\n\n- **Node.js** (v14.x or later)\n- **npm** (v6.x or later)\n- **Python** (v3.8 or later)\n- **pip** (v20.x or later)\n\n## Installation\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/katanabana/HolidRoute.git\n   cd HolidRoute\n   ```\n\n2. **Install dependencies for the frontend:**\n\n   ```bash\n   cd client\n   npm install\n   ```\n\n3. **Install dependencies for the backend:**\n\n   ```bash\n   cd ../server\n   pip install -r requirements.txt\n   ```\n\n## Running the Application\n\nTo run the application on your local machine, you'll need to start both the frontend and backend servers in separate\nterminals.\n\n1. **Start the frontend:**\n\n   Open the first terminal and run:\n\n   ```bash\n   cd client\n   npm start\n   ```\n\n   This will start the React development server, usually at `https://localhost:3000`.\n\n2. **Start the backend:**\n\n   Open the second terminal and run:\n\n   ```bash\n   cd server\n   python main.py\n   ```\n\n   This will start the Python backend server, usually at `https://localhost:5000`.\n\nNow, you can access the application by opening your browser and navigating to `http://localhost:3000`.\n\n## Environment Variables\n\nThis project requires certain environment variables to be set in both the frontend and backend to function properly.\nBelow are the details on how to set them up.\n\n### server/.env\n\n```plaintext\n# Domain where frontend is hosted (being served from)\nFRONTEND_URL=https://localhost:3000\n\n# Your or public Geoapify API key (the key below is public)\nGEOAPIFY_API_KEY=d548c5ed24604be6a9dd0d989631f783\n\n# The port on which the backend server will run.\nPORT=5000\n\n# The host on which the backend server will listen.\nHOST=localhost\n\n# Path to the SSL key file (for HTTPS).\nSSL_KEY=key.pem\n\n# Path to the SSL certificate file (for HTTPS).\nSSL_CERT=cert.pem\n```\n\n### client/.env\n\n```plaintext\n# The URL of the backend server.\nREACT_APP_BACKEND_URL=https://localhost:5000\n\n# Enforce HTTPS for precise location detection.\nHTTPS=true\n\n# Path to the SSL certificate file (for HTTPS).\nSSL_CRT_FILE=cert.pem\n\n# Path to the SSL key file (for HTTPS).\nSSL_KEY_FILE=key.pem\n```\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkatanabana%2Fholidroute","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkatanabana%2Fholidroute","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkatanabana%2Fholidroute/lists"}