Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zahidedusgun/travelmind
Travel Adviser supported by OpenAI
https://github.com/zahidedusgun/travelmind
mui mui-material nodejs openai-api reactjs
Last synced: about 2 months ago
JSON representation
Travel Adviser supported by OpenAI
- Host: GitHub
- URL: https://github.com/zahidedusgun/travelmind
- Owner: zahidedusgun
- Created: 2024-03-18T11:13:32.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-05-22T23:56:35.000Z (8 months ago)
- Last Synced: 2024-05-23T00:50:49.628Z (8 months ago)
- Topics: mui, mui-material, nodejs, openai-api, reactjs
- Language: JavaScript
- Homepage:
- Size: 3.27 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TravelMind 🌍
**TravelMind**, seyahat planlaması sürecinde yaşanan vakit kaybına çözüm sunmak amacıyla geliştirilmiş bir yapay zekâ destekli seyahat planlama uygulamasıdır. Proje, kullanıcıların seyahat tercihlerini temel alarak kişiselleştirilmiş öneriler sunar ve zaman kazandırır.
## Proje Amacı
TravelMind, bireylerin seyahat planlama sürecinde yaşadıkları zorluklara çözüm bulmak amacıyla geliştirilmiştir. Uygulama, kullanıcılardan alınan bilgilere göre kişiye özel seyahat planları oluşturarak zaman kazandırır. Bu sayede, çocuklu aileler, alışveriş severler veya kültür meraklıları gibi farklı kullanıcı gruplarının ihtiyaçlarına yönelik planlar sunar.
## Özellikler
- **Kullanıcı Dostu Arayüz**: Kolay ve anlaşılır arayüz sayesinde herkes tarafından rahatlıkla kullanılabilir.
- **Kişiselleştirilmiş Seyahat Planları**: Kullanıcılardan alınan bilgilere göre yapay zeka tarafından kişiselleştirilmiş seyahat planları oluşturulur.
- **Seyahat Amacına Göre Planlar**: Çocuk dostu, kültürel geziler, alışveriş turları gibi seçeneklerle kişiye uygun planlar sunar.
- **Görseller ve Harita Bilgileri**: Önerilen mekanların görsellerini ve Google Maps entegrasyonu ile konum bilgilerini sağlar.
- **Mesafe Bilgileri**: Önerilen mekanlar arasındaki araba ve yürüyüş mesafelerini süre bilgisiyle birlikte sunar.
- **E-posta ile Paylaşım**: Kullanıcılar, oluşturdukları seyahat planlarını e-posta ile paylaşabilirler.
## Teknik Altyapı
### Backend
- **Node.js**: Uygulamanın sunucu tarafı Node.js ile inşa edilmiştir.
- **Nodemailer**: Kullanıcıların seyahat önerilerini e-posta ile paylaşabilmeleri için Nodemailer entegrasyonu kullanılmıştır.
- **GPT-3.5 API**: Kişiselleştirilmiş seyahat önerilerini oluşturmak için OpenAI GPT-3.5 API kullanılmıştır.
- **Google Places ve Maps API**: GPT-3.5'in önerdiği mekanların görselleri ve harita bilgileri için Google API'leri entegre edilmiştir.
- **Weather API** *(future)*: Seyahat planlarına hava durumu tahminlerini eklemek amacıyla Weather API entegrasyonu planlanmıştır.
### Frontend
- **React.js**: Uygulamanın ön yüzü React.js kullanılarak geliştirilmiştir.
- **MUI (Material User Interface)**: Kullanıcı arayüzü tasarımında MUI bileşenleri kullanılmıştır.
- **DALL-E**: Görsel içeriklerin oluşturulması için DALL-E yapay zekâ aracı kullanılmıştır.
## Nasıl Çalışır?
1. Kullanıcı, gideceği yer, seyahat amacı ve tarih bilgilerini form aracılığıyla paylaşır.
2. GPT-3.5 bu bilgileri analiz eder ve kişiye özel seyahat önerileri sunar.
3. Önerilen mekanlar ve etkinliklerin görselleri ve harita bilgileri kullanıcıya sunulur.
4. Kullanıcı, seyahat planını e-posta ile paylaşabilir.
## Kurulum
1. **Depoyu Klonlayın:**
```bash
git clone https://github.com/kullaniciadi/travelmind.git
```
2. **Bağımlılıkları Yükleyin:**
```bash
cd travelmind
npm install
```
3. **API Anahtarlarınızı Tanımlayın:**
`config.js` dosyasını doldurarak GPT-3.5, Google Places/Maps ve Nodemailer için API anahtarlarını ekleyin.
4. **Projeyi Çalıştırın:**
```bash
npm start
```
## Arayüz Görselleri
