# readyAI

**Repository Path**: jeadyx/ready-ai

## Basic Information

- **Project Name**: readyAI
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-27
- **Last Updated**: 2025-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ready AI

Ready AI 是一个基于 Electron 和 React 的桌面应用程序，提供了便捷的 AI 模型管理和对话功能。该应用程序集成了 Ollama 服务，让用户可以轻松下载、管理和使用各种 AI 模型。

## 主要功能

- 🤖 AI 模型管理
  - 支持多个主流模型：deepseek-coder、codellama、llama2 等
  - 显示模型大小和下载状态
  - 断点续传下载功能
  - 实时下载进度显示

- 💬 对话功能
  - 支持与已安装的 AI 模型进行对话
  - 实时响应
  - 历史记录保存

- 🛠 系统功能
  - 自动管理 Ollama 服务
  - 智能文件管理
  - 优化的解压缩处理
  - 完整的错误处理机制

## 系统要求

- Windows 10 或更高版本
- Node.js 14.0 或更高版本
- 最小 8GB RAM 建议配置

## 安装说明

1. 克隆项目仓库：
\`\`\`bash
git clone [repository-url]
cd ReadyAI
\`\`\`

2. 安装依赖：
\`\`\`bash
npm install
\`\`\`

3. 启动应用：
\`\`\`bash
npm start
\`\`\`

## 使用说明

1. 首次启动
   - 应用会自动下载并安装 Ollama 服务
   - 下载过程中会显示详细的进度信息
   - 安装完成后会显示欢迎界面

2. 模型管理
   - 在左侧菜单选择"模型管理"
   - 查看可用模型列表
   - 点击"下载"按钮开始下载所需模型
   - 下载过程中可以查看实时进度

3. 对话功能
   - 在左侧菜单选择"聊天"
   - 选择已安装的模型
   - 开始与 AI 进行对话

## 文件目录说明

- `/dep/models` - AI 模型存储目录
- `/download` - 临时下载文件目录
- `/src` - 源代码目录
  - `/components` - React 组件
  - `/App.tsx` - 主应用组件
- `/electron` - Electron 相关代码
  - `/main.js` - 主进程代码
  - `/download.html` - 下载进度界面

## 注意事项

1. 确保有足够的磁盘空间用于下载和存储模型
2. 下载大型模型时建议使用稳定的网络连接
3. 模型下载过程中请勿强制关闭应用
4. 首次使用新模型时可能需要一定的加载时间

## 常见问题

1. 下载中断
   - 应用支持断点续传，重新打开应用即可继续下载
   - 检查网络连接是否稳定

2. 内存占用过高
   - 应用已优化文件处理机制，采用流式处理和分批处理
   - 可以关闭不使用的模型释放内存

3. 解压过程卡顿
   - 解压过程已优化，采用分批异步处理
   - 请耐心等待解压完成

## 更新日志

### v1.0.0
- 初始版本发布
- 支持基础模型管理和对话功能
- 实现智能文件下载和解压功能

## 技术支持

如有问题或建议，请通过以下方式联系：
- 提交 Issue
- 发送邮件至 [support-email]

## 许可证

[License 信息]