# YssAgent

YssAgent 是一站式 AI 智能体工作台，可统一管理数字员工、模型、知识库、技能、工具、定时任务和执行记录。

## 技术栈

- 前端：React、TypeScript、Vite
- 后端：FastAPI、SQLModel
- 数据库：SQLite
- 生产入口：`backend/single_port_app.py`

## 本地开发

1. 根据 `backend/.env.example` 创建仅供本地使用的 `.env`。
2. 在 `frontend-enterprise` 执行 `npm ci`。
3. 在 `backend` 创建 Python 虚拟环境并安装本项目。
4. 从仓库根目录运行 `python scripts/dev.py up`。

生产环境必须使用强随机 `APP_SECRET` 和管理员密码，关闭演示用户，并将数据库放在独立持久化目录。不要把 `.env`、数据库或模型 API Key 放进源码包。

## 许可与源码

本项目是经过修改的网络应用，依据 GNU Affero General Public License v3 发布。完整条款见 `LICENSE`，修改与来源说明见 `THIRD_PARTY_NOTICES`。运行中的对应源码可通过 YssAgent 登录页的“获取源码”入口免费下载。

本软件按现状提供，不附带任何明示或默示担保。

