{"id":22045136,"url":"https://github.com/msull/emilytarot","last_synced_at":"2025-05-08T07:28:46.470Z","repository":{"id":171752124,"uuid":"648297393","full_name":"msull/emilytarot","owner":"msull","description":"AI Tarot Readings powered by Streamlit and GPT","archived":false,"fork":false,"pushed_at":"2024-07-19T20:28:24.000Z","size":31813,"stargazers_count":31,"open_issues_count":2,"forks_count":9,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-31T17:25:00.267Z","etag":null,"topics":["gpt","python","streamlit","streamlit-application"],"latest_commit_sha":null,"homepage":"https://emilytarot.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/msull.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2023-06-01T16:36:47.000Z","updated_at":"2025-03-19T18:54:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"8ee2cc44-74b3-4747-8d14-95e4d1acc09d","html_url":"https://github.com/msull/emilytarot","commit_stats":null,"previous_names":["msull/emilytarot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msull%2Femilytarot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msull%2Femilytarot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msull%2Femilytarot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msull%2Femilytarot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msull","download_url":"https://codeload.github.com/msull/emilytarot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253020125,"owners_count":21841499,"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":["gpt","python","streamlit","streamlit-application"],"created_at":"2024-11-30T13:11:40.667Z","updated_at":"2025-05-08T07:28:46.447Z","avatar_url":"https://github.com/msull.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Emily Tarot\n\nEmily Tarot is a techno-mystic project that leverages OpenAI's GPT-3.5-turbo for generating Tarot card readings. This\nproject was designed as an experiment to learn Streamlit and to explore working with large language models for custom\napplications. Hosted at [EmilyTarot.com](http://emilytarot.com).\n\n\u003e Note: This project is now using the incredible GPT-4-omni-mini model!\n\n## Features\n\n* User Interface: The project uses Streamlit to create a visually engaging and intuitive interface for the users to\n  interact with.\n* Techno-Mystic Experience: Users are guided through a Tarot reading session where they can choose from a virtual deck\n  of Tarot cards or use their own physical deck.\n* AI Interaction: The selected cards and user's questions are processed by OpenAI's GPT-3.5-turbo model to generate a\n  personalized Tarot reading.\n* Session Persistence: The state of the current session is maintained across Streamlit reruns, providing a continuous\n  experience to the user.\n* Moderation: The user's input is checked and moderated for any inappropriate content, terminating the session and\n  displaying crisis resources when user content is flagged\n* Docker Support: A Dockerfile and docker-compose files are included to facilitate the deployment and running of the\n  application.\n\n## Usage\n\nTo run Emily Tarot locally, follow these steps:\n\n1. Clone this repository.\n2. Install the dependencies: `pip install -r requirements.txt`\n3. Set up environment variables `SESSION_DIR` and `OPENAI_SECRET_KEY`.\n4. Use `cd src \u0026\u0026 streamlit src/streamlit_app.py` to start the Streamlit application.\n5. Navigate to `http://localhost:8501` in your web browser to interact with Emily Tarot.\n\nTo build and run Emily Tarot with Docker:\n\n1. `docker-compose build`\n2. `docker-compose up`\n3. The application should be available at `http://localhost:9999`.\n\n## License\n\nThis project is licensed under the terms of the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsull%2Femilytarot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsull%2Femilytarot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsull%2Femilytarot/lists"}