# Trae

**Repository Path**: jade-jumper-tech/trae

## Basic Information

- **Project Name**: Trae
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-10
- **Last Updated**: 2026-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LLM Tool Calling Demo

一个完整的LLM工具调用演示项目，展示如何将视觉工具与大语言模型集成。

## 功能特性

- **多供应商支持**: 支持 OpenAI、Anthropic、Gemini、Ollama 等多种AI供应商
- **实时对话**: 基于 Server-Sent Events (SSE) 的实时聊天界面
- **技能系统**: 可扩展的工具/技能注册和调用机制
- **图像库**: 内置图像管理和上传功能
- **命令行接口**: 提供CLI工具供其他Agent调用
- **对话持久化**: 自动保存和加载对话历史

## 目录结构

```
demo5_llm_tool_calling/
├── server.py                     # 后端核心（ASGI服务）
├── cli.py                        # 命令行接口
├── index.html                    # 前端页面
├── styles.css                    # 样式文件
├── ai_config.json                # AI供应商配置
├── pytest.ini                    # pytest配置
├── README.md                     # 项目说明
├── TEACHING_OUTLINE_45MIN.md     # 课程大纲
├── COURSE_LOG_45MIN.md           # 课程日志
├── js/                           # 前端模块
│   ├── utils.js
│   ├── state.js
│   ├── resize.js
│   ├── json-panels.js
│   ├── image-library.js
│   ├── pipeline.js
│   ├── toolbox.js
│   ├── skills.js
│   ├── skill-editor.js
│   ├── chat.js
│   ├── settings.js
│   ├── conversation.js
│   └── app.js
├── skills/                       # 技能定义
│   └── *.json
├── conversations/                # 对话存储
│   └── *.json
├── test_images/                  # 测试图像
├── uploads/                      # 用户上传
└── tests/                        # 测试文件
```

## 快速开始

### 安装依赖

```bash
pip install fastapi uvicorn httpx python-multipart python-dotenv
```

### 配置AI密钥

编辑 `ai_config.json` 文件，设置你的API密钥：

```json
{
  "active_provider": "openai",
  "providers": {
    "openai": {
      "api_key": "your-api-key-here",
      ...
    }
  }
}
```

### 启动服务

```bash
python server.py
```

服务将在 http://localhost:8000 运行。

### 命令行使用

```bash
python cli.py --help
python cli.py analyze-image test_images/city_day.jpg
```

## API接口

### POST /api/chat
发起聊天请求（SSE流式响应）

### POST /api/skills
获取/注册技能

### POST /api/images
上传图像

### GET /api/conversations
获取对话列表

### POST /api/conversations/{id}
获取单个对话详情

## 技术栈

- **后端**: Python 3.10+, FastAPI, Uvicorn, SSE
- **前端**: Vanilla JS, TailwindCSS 3, Font Awesome
- **存储**: 文件系统（JSON格式）
- **测试**: pytest, pytest-asyncio

## 许可证

MIT License