wlad is a holistic wellness assistant for guided meditation and reflective moments. The application uses AI to generate personalized content, recommend relevant meditation sessions, and provide audio capabilities for both meditation and reflective moments.

• 🧘‍♂️ guided meditation sessions with content-aware recommendations
• 🤖 ai-generated meditation texts using gpt-3.5 turbo
• 📝 personal reflective moments creation and management
• 🎙️ text-to-speech conversion for reflective moments
• 🎧 unified audio playback system with speed control (0.75x-2.0x)
• 🗃️ personal library of meditations and reflective moments
• 🎨 intuitive user interface with a calming theme
• 🔒 user-friendly authentication system
• 📱 cross-platform: android, ios, and web

• backend api: fastapi backend for user authentication, meditation management, content recommendations, moment generation, and audio conversion
• ai models: integration with openai's gpt-3.5 turbo and whisper for content generation and transcription
• frontend: flutter interface for users to interact with meditations and reflective moments

• flutter (dart)
• provider (state management)
• just_audio (audio playback)
• http (api requests)

• fastapi (python)
• mongodb (with motor async driver)
• openai api (for text generation and text-to-speech conversion)
• vector embeddings (for content-aware recommendations)

• docker & docker compose (for services orchestration)

before running the application, you need to set up the environment:

1. create a .env file in the frontend directory with the following content:

   API_BASE_URL=http://localhost:8000
   

2. if you're running the app on a different device than the server:

   • find your server's IP address (e.g., 192.168.1.100)
   • update the .env file to use that IP:

   API_BASE_URL=http://192.168.1.100:8000
   

3. for web deployment, use your domain:

   API_BASE_URL=https://your-domain.com
   

to start the entire application including the backend, database, and ai services:

# from the root directory
docker-compose up

this will start:

• the main backend api at http://localhost:8000
• mongodb database
• ai services

1. register a new account or login
2. discover meditations through content-aware recommendations
3. generate custom meditations based on your specific needs
4. create reflective moments or generate them with ai
5. convert your moments to audio with one click
6. listen to your meditations and moments with the integrated audio player
7. manage your personal library of content

the application offers a complete wellness experience through:

1. content-aware recommendations: find meditation content that matches your emotional needs
2. custom meditation generation: create personalized meditation scripts on demand
3. reflective moments: create, manage and listen to your personal reflections
4. unified audio experience: seamless playback for both meditation and reflective content
5. personalized content management: build your own library of wellness resources

wlad/
├── backend/
│   ├── api/                # fastapi backend
│   │   ├── routes/         # api endpoints
│   │   ├── models/         # data models
│   │   ├── services/       # business logic services
│   │   └── config.py       # configuration settings
│   ├── ai/                 # ai models integration
│   └── uploads/            # uploaded files and generated audio
├── frontend/
│   ├── lib/                # flutter app source code
│   │   ├── screens/        # app screens/pages
│   │   ├── models/         # data models
│   │   ├── providers/      # state management
│   │   └── services/       # api services
│   └── assets/             # app images and icons
└── docker-compose.yml      # main docker compose file

to make changes to the application:

1. fork the repository
2. make your changes
3. test with the docker setup
4. submit a pull request

for more detailed documentation, see the readme files in the specific component directories.