Skip to content

About

Your healthy partner

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

33 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wellbeing Agent - 智能健康顾问

一个基于 LangGraph 和 React 的智能健康顾问系统,提供个性化的健康建议和运动指导。

🏗️ 项目结构

langgraph-agent/
├── frontend/              # 前端应用 (React + TypeScript)
│   ├── src/              # React 源代码
│   ├── package.json      # 前端依赖配置
│   └── start.sh          # 前端启动脚本
├── production_server.py  # 生产环境后端 API 服务器
├── wellbeing_agent.py    # 核心健康顾问代理
├── deepseek_llm.py      # DeepSeek LLM 集成
├── requirements.txt      # Python 依赖
├── setup.py             # 项目设置脚本
└── env.example          # 环境变量模板

🚀 快速开始

1. 启动后端服务

# 安装 Python 依赖
pip install -r requirements.txt

# 配置环境变量
python setup.py

# 启动后端服务器
python production_server.py

2. 启动前端应用

# 方法1:使用启动脚本
./start_frontend_only.sh

# 方法2:手动启动
cd frontend
npm install
npm run dev

3. 访问应用

🛠️ 技术架构

后端

  • LangGraph - 代理编排框架
  • FastAPI - 高性能 Web API 框架
  • DeepSeek - 大语言模型集成
  • Python 3.8+ - 核心开发语言

前端

  • React 18 - 用户界面库
  • TypeScript - 类型安全的 JavaScript
  • Tailwind CSS - 实用优先的 CSS 框架
  • Vite - 快速的前端构建工具

🎯 核心功能

  • 智能健康咨询 - 基于 AI 的健康建议
  • 运动指导 - 个性化运动计划
  • 饮食建议 - 营养搭配指导
  • 健康管理 - 生活方式优化
  • 流式输出 - 实时响应体验
  • LangSmith 追踪 - 可视化链路追踪和监控

📁 目录说明

前端 (frontend/)

  • 完全独立的前端应用
  • 使用现代 React 技术栈
  • 支持热重载和快速开发

后端 (根目录)

  • LangGraph 代理系统
  • FastAPI 服务器
  • 健康顾问核心逻辑

🔧 开发说明

前端开发

cd frontend
npm run dev          # 启动开发服务器
npm run build        # 构建生产版本
npm run preview      # 预览生产版本

后端开发

python production_server.py    # 启动生产服务器
python wellbeing_agent.py     # 运行健康顾问代理

🔗 LangSmith 集成

本项目集成了 LangSmith 用于 LLM 应用的可观测性和调试。

快速设置

# 运行设置脚本
./setup_langsmith.sh

# 或手动设置
cp env.example .env
# 编辑 .env 文件,添加你的 LangSmith API 密钥

查看追踪

  1. 获取 LangSmith API 密钥:https://smith.langchain.com/
  2. 在 .env 文件中设置 LANGCHAIN_API_KEY
  3. 运行应用,查看实时追踪:https://smith.langchain.com/

测试集成

# 测试 LangSmith 连接和追踪
python test_langsmith.py

# 监控追踪数据
python langsmith_monitor.py

# 使用集成启动脚本
./start_with_langsmith.sh

LangSmith 功能

  • 实时追踪: 自动记录所有 LLM 调用和工作流节点
  • 性能监控: 追踪响应时间、错误率和成功率
  • 可视化分析: 在 LangSmith Dashboard 中查看详细链路
  • 调试支持: 深入分析每个节点的输入输出

详细说明请参考:LANGSMITH_SETUP.md

📚 文档

🚀 部署

前端部署

前端应用可以部署到任何静态文件托管服务:

  • Vercel, Netlify, GitHub Pages
  • AWS S3 + CloudFront

后端部署

  • Docker 容器化
  • 云服务器部署
  • 支持环境变量配置

🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目!

�� 许可证

MIT License

About

Your healthy partner

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages