Repolode
Submit
dreamhunter2333

dreamhunter2333/chatgpt-tarot-divination

A ChatGPT-based AI fortune-telling app offering tarot, BaZi, name analysis, dream interpretation and Meihua divination with streaming output.

View on GitHubWebsite
Stars
972
Forks
247
Open issues
20
Last commit
11 days ago

What is it?

This project is a web app that uses the ChatGPT API to produce divination readings. Users pick a method such as tarot, BaZi (birth-time chart), name analysis by five-grid stroke counts, Zhou Gong dream interpretation, Meihua Yishu, name suggestions based on birth data and the five elements, or a love-fortune reading. Results stream in as they are generated, and each divination type keeps the 10 most recent records.

The app runs in three ways: deployed to Vercel with an OpenAI key set as an environment variable, installed as a desktop client for macOS, Windows or Linux, or started with Docker. Developers can also run the Node.js frontend and Python backend locally. The layout adapts to phones, tablets and desktops, and includes a dark mode.

Optional settings cover the API base URL, model name, rate limits, GitHub OAuth login and ad slots. For local runs, the API style can be switched between chat and responses, which is needed for reasoning models.

Key features

  • 01Tarot, BaZi, five-grid name analysis, dream interpretation, Meihua Yishu and name suggestions are supported.
  • 02AI readings stream in with a typewriter effect.
  • 03Each divination type keeps the 10 most recent records.
  • 04Layout adapts to phones, tablets and desktops, with a dark mode.
  • 05Deployable via Vercel, desktop installers, Docker or local development.

Use cases

  • Trying out tarot or BaZi readings powered by ChatGPT for entertainment.
  • Hosting a private fortune-telling web app for friends or a small community.
  • Studying how to wire a streaming LLM chat interface into a Next.js or Python backend.

Quick start

  1. 1

    Deploy to Vercel with one click, setting the api_key environment variable

  2. 2

    Create docker-compose.yml with the service definition from the README

  3. 3

    Start the service in the background

    docker-compose up -d
  4. 4

    Open http://localhost:8000 in a browser

Things to know

  • Requires an OpenAI API key, and usage incurs API costs.
  • The local development setup needs Node.js 22+, Python 3.11+ and pnpm.

In collections

Self-hosted appsStreaming tools

Topics

#ai#chatgpt#tarot#divination#openai#streaming#self-hosted

FAQ

What is chatgpt-tarot-divination?
A ChatGPT-based AI fortune-telling app offering tarot, BaZi, name analysis, dream interpretation and Meihua divination with streaming output. This project is a web app that uses the ChatGPT API to produce divination readings. Users pick a method such as tarot, BaZi (birth-time chart), name analysis by five-grid stroke counts, Zhou Gong dream interpretation, Meihua Yishu, name suggestions based on birth data and the five elements, or a love-fortune reading. Results stream in as they are generated, and each divination type keeps the 10 most recent records.
Is chatgpt-tarot-divination free to use? What license does it have?
chatgpt-tarot-divination is open source under the MIT license. Check the license terms before using it in commercial products.
Is chatgpt-tarot-divination still maintained?
Actively maintained. The last commit to chatgpt-tarot-divination was on Oct 28, 2026.
What can I use chatgpt-tarot-divination for?
Trying out tarot or BaZi readings powered by ChatGPT for entertainment. Hosting a private fortune-telling web app for friends or a small community. Studying how to wire a streaming LLM chat interface into a Next.js or Python backend.
How do I install chatgpt-tarot-divination?
Deploy to Vercel with one click, setting the api_key environment variable Create docker-compose.yml with the service definition from the README Start the service in the background: docker-compose up -d Open http://localhost:8000 in a browser
Where can I get chatgpt-tarot-divination?
The source code and installation instructions are on GitHub: https://github.com/dreamhunter2333/chatgpt-tarot-divination

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects