问天AI (WenTian AI)

一个将大语言模型 (LLM) 与中国传统文化《周易》（I Ching） 深度结合的AI问卦/解卦应用。

通过自然语言与AI对话，你可以像古代贤者一样"问天"——求卦、解卦、预测运势、人生建议，甚至结合现代事件进行周易解读。

🌐 在线体验

立即体验问天AI：https://wtian.cloud/

🌟 项目特色

• 传统算法与现代AI融合：核心测算公式经过多部经典易经书籍总结提炼，保证算法的古典韵味与精准度
• 大模型深度分析：利用大语言模型进行智能解卦，支持多种LLM（如通义千问、ChatGPT、Claude等），提供专业而富有洞见的解读
• LangChain框架集成：应用LangChain框架优化提示词工程，提升AI问卦的准确性和表达质量
• 多样化起卦方式：支持手动输入、随机摇卦、报数起卦、时间起卦等多种传统起卦方法
• 完整的前后端分离架构：前端 Vue3 + Element Plus，后端 FastAPI + LangChain
• Docker一键部署：轻松本地运行或云部署，支持多模型切换、历史记录、卦象可视化

📸 效果展示

首页

八字排盘

八字分析

八卦起卦

八卦分析

🏗️ 软件架构

wtian/
├── api/          # FastAPI 后端代码（LangChain + LLM 调用）
├── ui/           # Vue3 前端代码（Vite + Element Plus）
├── docker/       # Docker Compose 配置
└── README.md

技术栈：

• 后端：Python 3.10+、FastAPI、LangChain、Pydantic
• 前端：Vue 3、Pinia、Vue Router、Element Plus
• 部署：Docker + Docker Compose
• LLM 支持：Qwen、通义千问、OpenAI、Claude、Gemini 等（通过 API Key 配置）

🚀 安装教程

方式一：Docker 部署（推荐）

# 克隆仓库
git clone https://github.com/timmy1688/wtian.git
cd wtian

# 复制环境变量示例文件并填写你的 API Key
cp .env.example .env
# 编辑 .env 文件，填写你的大模型 API Key（如 QWEN_API_KEY、OPENAI_API_KEY 等）

# 启动
docker-compose up -d

访问地址：http://localhost:8080 （前端）
API 地址：http://localhost:8000

方式二：本地开发运行

后端

cd api
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

# 配置 .env 文件
cp .env.example .env

uvicorn main:app --reload --port 8000

前端

cd ui
npm install
npm run dev

📖 使用说明

1. 打开网页，进入“问天”页面
2. 输入你的问题（如“明年事业运势如何？”）
3. 选择起卦方式（默认AI智能起卦）
4. AI 将自动为你起卦、变卦、解卦，并结合大模型给出深度解读
5. 支持导出卦象、保存历史记录

🤝 参与贡献

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feat/xxx)
3. 提交你的改动 (git commit -m 'feat: 添加 xxx 功能')
4. Push 到分支 (git push origin feat/xxx)
5. 打开 Pull Request

欢迎提交 Issue 或 PR，一起把周易与AI结合得更完美！

📄 许可证

MIT License （如无LICENSE文件，可自行选择开源协议）

---

问天AI —— 让千年智慧遇见现代AI，古为今用，问道未来。

如果觉得项目不错，欢迎点个 Star ✨ 支持一下！