# chatsome

**Repository Path**: sleepywang1024/chatsome

## Basic Information

- **Project Name**: chatsome
- **Description**: "聊点什么"是一个AI大模型聊天项目，初步目的是学习和验证相关技术。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-16
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# "聊点什么"

## 项目简介

"**聊点什么**"是一个免费开源的、基于大模型的问答与聊天项目，目的是用于LLM应用的相关技术验证和规范架构设计。当然你可以用于你希望的任意其它场景。

## 产品能力

- **提问与聊天**，接收用户自然语言输入，并与之对话：回答问题或日常响应.
- **互联网搜索**，基于用户问题内容自动判断，需要时进行互联网搜索，结合搜索内容进行回答.
- **上下文连续**，自动维护用户会话上下文，具备短期和长期记忆能力。
- **多对话支持及管理**，同时支持多个对话，并对它们进行管理。
- **自然语言操作**，通过自然语言完成基本的界面操作，例如新建对话、清除历史等（todo）
- **其它基本能力**，注册、登录、退出、设置等功能。
  **注意**:由于产品定位问题，未提供规划-执行-响应的复杂智能链能力,将来计划在另一个产品做这个事情。

  ## 首页截图

  ![系统首页](home.png)

## 选型与架构

### 选型目标

开源免费可商用、简洁灵活强大，适合低成本快速开发，长期演进支持复杂业务需求.

### 后端

- **Python**：最适合AI原生的开发环境。
- **SQLModel**:简洁、灵活、现代的OR映射框架
- **FastAPI**：现代、简洁、前后端分离适合多前端同时接入
- **pytest**：简单且强度的单元测试工具
- **LangChain/OpenAI**：AI智能体是新领域，各类技术都不成熟，暂时选一个相对灵活、应用广泛的框架。虽然对它不咋满意，有机会后面写个框架，欢迎有相关兴趣的小伙伴沟通交流。
- 其它工具

### 前端

- **Vue3 + Vite + Element Plus**：国内友好的前端框架，更容易上手，适合快速开发。
- **TypeScript**：完全兼容JavaScript，强大、类型安全的语言。没有起步成本，且能力丰富，适合大型项目。

## 安装部署

### 后端

- 安装依赖：`pip install -r requirements.txt`
- 参数设置：参照`.env.example 创建 .env文件并设置正确参数`
- 创建数据库：执行 python app/database.py
- 运行WEB服务：`python -m uvicorn app.main:app --reload`
- 运行单元测试：`pytest`

### 前端

- [参考WEB README.md](./cs_web/README.md)
- [vite.config.ts路由修改](./cs_web/vite.config.ts)

```json
server: {
    port: 5173,
    proxy: {
      '/api': {
        target: 'http://127.0.0.1:8000', // 你的 FastAPI 地址
        changeOrigin: true,
      },
    },
  },
```

## 其它

由于核心目的是架构设计及技术验证，本项目采取手搓方式而不是vibe coding。当技术架构规范完善后，通过skills规范的形式实现开发自动化。

## 联系方式

- 公众号：向AGI前进
- 邮箱：sleepywang@qq.com
- 微信：seepywang