Skip to content

MichaelCurrin/meditation-app

Repository files navigation

Meditation app

Python-based meditation app powered by LLM for content and text-to-speech output

GitHub tag License

Made with Python dependency - poetry

Instead of a pre-recorded guided meditation, you can create your own custom one and adapt it in real-time. It is interactive, so the AI gives you a scene and choices and you pick an option, like a text-based adventure video game.

To keep your journey and what your share private, configure the app to use a local LLM like Ollama. See OpenAI-related options here.

Limitations

  • When using pyttsx3 the voice is poor quality.
  • When using Kokoro like in this demo it can be so slow it is usuable (depending on your machine specs).
  • Or use an API service, but that requires signup and subscription costs.
  • The input is text and ideally it can listen to your voice.

Requirements

  • Python
  • Poetry
  • make (on Linux or macOS)
  • Ollama

Installion

make install

Run

make run-llama

With enhanced audio:

make run-llama-kokoro

To disable text-to-speech while keeping text output:

make run-llama-silent

License

Released under MIT by @MichaelCurrin.

About

Python-based meditation app powered by LLM for content and text-to-speech output

Topics

Resources

License

Stars

Watchers

Forks

Contributors