# KakakeAgents

**Repository Path**: kakake/kakake-agents

## Basic Information

- **Project Name**: KakakeAgents
- **Description**: Kakake智能体
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KakakeAgents 项目说明文档

## 项目简介

KakakeAgents 是一个基于 LangGraph 的深度研究代理系统，包含服务端和前端两部分。该系统能够使用多种 AI 模型（如 Gemini、Claude、Qwen）进行网络研究，并通过前端界面与用户交互。

## 核心功能

### 服务端（Server）

- **深度研究代理**：基于 LangGraph 和 DeepAgents 构建的智能研究系统
- **多模型支持**：可使用 Gemini 3、Claude 4.5、Qwen 3.5 等多种 AI 模型
- **网络搜索能力**：集成 Tavily 搜索工具，能够进行网络搜索并分析结果
- **子代理系统**：支持委派任务给专门的研究子代理
- **LangGraph Studio**：提供可视化的工作流管理界面

### 前端（Web）

- **用户友好界面**：构建好的 Next.js 前端应用
- **静态部署**：可通过任何静态文件服务器提供服务
- **响应式设计**：适配不同设备屏幕尺寸

## 技术栈

### 服务端

- Python 3.13
- LangGraph
- DeepAgents
- LangChain
- 多种 AI 模型集成（Google Gemini、Anthropic Claude、Alibaba Qwen）
- Tavily 搜索 API

### 前端

- Next.js
- React
- 静态文件部署

## 快速开始

### 1. 环境要求

- Python 3.11 或更高版本
- uv 包管理器（推荐）
- Node.js（可选，用于前端开发）
- 静态文件服务器（如 serve 或 Python 的 http.server）

### 2. 安装依赖

#### 服务端依赖

```bash
cd src
uv sync
```

### 3. 配置 API 密钥

在 `src/.env` 文件中配置以下 API 密钥：

```env
# Server Configuration
SERVER_PORT=2000
WEB_PORT=3000

# OpenAI API Key (for GPT-4o-mini summarization)
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1

# Model Name
MODEL_NAME=qwen3.5-plus-2026-02-15

# Tavily API 密钥（用于网络搜索）
TAVILY_API_KEY=your_tavily_api_key_here

# LangSmith API 密钥（可选，用于追踪和监控）
LANGSMITH_API_KEY=your_langsmith_api_key_here
```

### 4. 启动项目

#### 启动服务

```bash
uv run python main_web.py
```

- 前端启动后，可通过以下地址访问：
`http://localhost:3000`

## QA
1、Qwen 大模型的 API 密钥如何获取？
   - [登录阿里云百炼](https://bailian.console.aliyun.com/) 可以免费获取 Qwen 3.5 模型的 API 密钥。

2、如果执行`uv sync`报错，可能的原因是缺少必要的 Python 包。可以尝试以下解决方法：
   - 检查 Python 版本是否与项目要求一致（3.13）
   - 确保已安装 uv 包管理器（可以通过 `pip install uv` 安装）
   - 如果是Windows系统，还需要安装Visual C++ Build Tools（可以通过[Visual Studio Installer](https://visualstudio.microsoft.com/visual-cpp-build-tools/)安装）

## 许可证

本项目采用 MIT 许可证。

## 联系方式

如有问题或建议，请通过以下方式联系：

- GitHub Issues：在项目仓库中提交 Issue
- 电子邮件：343588387@qq.com

---

**注意**：本项目使用了多种 AI 模型和 API 服务，使用前请确保遵守相关服务的使用条款和限制。