{"id":24901084,"url":"https://github.com/azazzillo/mandarin","last_synced_at":"2026-04-10T15:51:25.690Z","repository":{"id":275261489,"uuid":"919420415","full_name":"azazzillo/Mandarin","owner":"azazzillo","description":"MANDARIN is a recommendation platform that helps users find the best places to visit in their city based on their current mood. The website suggests venues such as cafes, restaurants, clubs, libraries, and theaters by analyzing user input and fetching highly rated locations.","archived":false,"fork":false,"pushed_at":"2025-02-01T07:53:35.000Z","size":14,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-27T18:18:27.299Z","etag":null,"topics":["alembic","backend","celery","chatgpt","fastapi","integration","postgresql","python","redis","selenium","uvicorn","vscode","web","website"],"latest_commit_sha":null,"homepage":"","language":null,"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/azazzillo.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":"2025-01-20T11:04:58.000Z","updated_at":"2025-02-01T07:54:12.000Z","dependencies_parsed_at":"2025-02-01T08:38:19.920Z","dependency_job_id":null,"html_url":"https://github.com/azazzillo/Mandarin","commit_stats":null,"previous_names":["azazzillo/mandarin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azazzillo%2FMandarin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azazzillo%2FMandarin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azazzillo%2FMandarin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azazzillo%2FMandarin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azazzillo","download_url":"https://codeload.github.com/azazzillo/Mandarin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245898319,"owners_count":20690466,"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":["alembic","backend","celery","chatgpt","fastapi","integration","postgresql","python","redis","selenium","uvicorn","vscode","web","website"],"created_at":"2025-02-01T21:15:00.267Z","updated_at":"2025-12-30T23:22:12.171Z","avatar_url":"https://github.com/azazzillo.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# MANDARIN | 2gis-parse-fastapi\n[🌐 Frontend Repository](https://github.com/azazzillo/mandarin_f)\n\n## About the Project\n**MANDARIN** is a recommendation platform that helps users find the best places to visit in their city based on their current mood. The website suggests venues such as cafes, restaurants, clubs, libraries, and theaters by analyzing user input and fetching highly rated locations.\n\n## How It Works\n1. The user describes their mood and submits a request.\n2. The request is sent to ChatGPT, which determines the type of venue that best matches the user's mood.\n3. The system uses Selenium to search for suitable places on **2GIS**.\n4. The best 1-3 venues are selected, and their top reviews are displayed to motivate the user to visit them.\n\n## Tech Stack\n- **Backend Framework:** FastAPI\n- **Database:** PostgreSQL\n- **Web Scraping:** Selenium\n- **Task Queue:** Celery + Redis\n- **AI Integration:** OpenAI API (ChatGPT)\n\n## Getting Started\n### Prerequisites\nEnsure you have Python installed on your system. Then, clone the repository:\n```bash\ngit clone https://github.com/azazzillo/MANDARIN.git\ncd MANDARIN\n```\n\n### Installation\n1. **Create a virtual environment:**\n```bash\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n```\n2. **Install dependencies:**\n```bash\npip install -r requirements.txt\n```\n\n### Running the Project\n1. **Start Redis:** *(Ensure Redis is installed and running)*\n```bash\nredis-server\n```\n2. **Start Celery worker:**\n```bash\ncelery -A app.celery worker --loglevel=info\n```\n3. **Run FastAPI server:**\n```bash\nuvicorn app.main:app --reload\n```\n\n### API Documentation\nOnce the server is running, you can access API documentation at:\n- Swagger UI: [http://127.0.0.1:8080/docs](http://127.0.0.1:8080/docs)\n- ReDoc: [http://127.0.0.1:8080/redoc](http://127.0.0.1:8080/redoc)\n\n## Related Projects\n- [Frontend for Mandarin (React App)](https://github.com/azazzillo/mandarin_f)\n\n## Contribution\nFeel free to contribute by submitting issues or pull requests!\n\n## License\nThis project is licensed under the MIT License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazazzillo%2Fmandarin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazazzillo%2Fmandarin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazazzillo%2Fmandarin/lists"}