XianTu

XianTu

"Immortal Path" AI-driven immersive cultivation text adventure game, based on Vue 3 + TypeScript + Fastapi, supports multiple AI models such as Gemini/Claude/OpenAI

Stars: 240

Visit
 screenshot

XianTu is an AI-driven immersive cultivation text adventure game that features dynamic storytelling with multiple large models, a complete cultivation system including realm breakthroughs, cultivation of techniques, equipment refining, and NPC interactions, intelligent decision-making system based on multiple dimensions, multiple save file management with cloud sync support, open world exploration with character relationship networks, cross-platform compatibility with dual themes, and compatibility with SillyTavern embedded environment and standalone web version.

README:

黑色主题 浅色主题

仙途(Xian Tu)

AI 驱动的沉浸式修仙文字冒险游戏

💬 QQ群:1079437686功能技术栈快速开始许可证

Vue 3 TypeScript Pinia Webpack FastAPI

Gemini Claude OpenAI SillyTavern

visitors stars forks

📖 游戏介绍🎮 在线体验


✨ 功能概览

🤖 AI 动态叙事 — 支持 Gemini / Claude / OpenAI / DeepSeek 等多种大模型,实时生成个性化剧情

⚔️ 完整修仙体系 — 境界突破、三千大道、功法修炼、装备炼制、NPC 互动

🎲 智能判定系统 — 基于境界、属性、装备、功法等多维度计算判定结果

💾 多存档管理 — 多角色、多存档槽位,支持导入导出与云同步

🗺️ 开放世界 — 自由探索朝天大陆,触发奇遇事件,建立人物关系网络

📱 全平台适配 — 完美支持桌面端与移动端,亮/暗双主题

🍺 酒馆兼容 — 支持 SillyTavern 嵌入式环境与独立网页版


🛠️ 技术栈

前端 后端 AI
Vue 3 + TypeScript Python + FastAPI Gemini API
Pinia 状态管理 SQLite / PostgreSQL Claude API
Vue Router JWT 认证 OpenAI API
Webpack WebSocket SillyTavern
Chart.js + Pixi.js DeepSeek
IndexedDB

🚀 快速开始

Docker 部署(推荐)

docker run -d -p 8080:80 qianye60/xiantu:latest

访问 http://localhost:8080 即可使用。

本地开发

# 安装依赖
npm install

# 开发模式
npm run serve

# 生产构建
npm run build

☁️ 自动构建/部署

推送 v* 格式的 tag 时自动触发:

  • Docker 镜像:构建并推送到 Docker Hub
  • GitHub Release:创建 Release 并上传构建产物 zip 包
git tag v3.7.0
git push origin v3.7.0

其他工作流:

  • CI:.github/workflows/ci.yml(push/PR 自动 type-check + build
  • Pages:.github/workflows/pages.yml(push 到 master 自动部署到 GitHub Pages)

后端(可选)

后端用于提供账号/存档等 API,默认使用 SQLite,开箱即用。

pip install -r server/requirements.txt
uvicorn server.main:app --reload --port 12345

环境变量配置见 server/.env.example


📖 更新日志

查看完整更新历史:CHANGELOG.md


🤝 贡献

欢迎提交 Issue 和 Pull Request!

详见 CONTRIBUTING.md


📄 许可证

本项目个人学习、研究免费使用。商业用途请先联系作者。

详见 LICENSE | 联系方式:QQ 1538548527


☕ 支持项目

如果这个项目对你有帮助,欢迎赞助支持~

微信赞助 支付宝赞助


如果觉得有帮助,请给个 ⭐ Star 支持一下!

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for XianTu

Similar Open Source Tools

For similar tasks

For similar jobs