alira

<div align="center">

<img src="./README/source/APIX-bar.jpeg"  width="300" height="200" style="border-radius: 12px; display: block; margin: 0 auto;">

# APIX — 开源 AI Agent 协作平台

中文文档 | [English](./README_en.md)

![Python](https://img.shields.io/badge/Python-3.11+-3776AB?style=flat&logo=python)
![Electron](https://img.shields.io/badge/Electron-37-47848F?style=flat&logo=electron)
![Vue](https://img.shields.io/badge/Vue-3.5-4FC08D?style=flat&logo=vue.js)
![License](https://img.shields.io/badge/License-GPL%203.0-blue?style=flat)
[![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?style=flat&logo=discord&logoColor=white)](https://discord.gg/bsTqEzJmJ)
![QQ群](https://custom-icon-badges.demolab.com/badge/QQ群-639459172-00BFFF?style=flat&logo=tencent-qq)

**不只是聊天。构建、协作、执行——让 AI Agent 真正为你工作。**

</div>

---

## APIX 3.0 正在开发中！

- 将重构底层 Agent Loop；
- 更清晰的项目目录结构；
- 更自由的系统拓展点；
- 引入内存型数据库，并设置可关闭缓存；
- 更便捷的安装部署方式；
- 更小的项目依赖；
- 将支持一键pip安装；

[前往 >APIX 3.0](https://github.com/JJJJSTIYYYY/Apix/tree/NEXT_3.0)

---

## 🎯 这是什么？

APIX 是一个**全栈的 AI Agent 协作平台**。它是一套完整的 Agent 运行时——支持多智能体并行协作、安全代码执行、知识库检索。

它可以帮你完成包括但不限于代码编写、PPT生成、汇报整理以及各种自动化操作。

---

## ✨ 核心特性

<table border="1" cellpadding="8" cellspacing="0" style="border-collapse: collapse; width: 100%;">
  <tr>
    <td align="center" width="33%">🤖<br><b>多智能体协作</b><br>Leader 调度多个子代理并行工作，复杂任务自动分解，实现Agent文件访问冲突检测</td>
    <td align="center" width="33%">🔧<br><b>完整工具生态</b><br>代码执行、文件管理、网络搜索、知识检索开箱即用</td>
    <td align="center" width="33%">🧠<br><b>完善的记忆系统</b><br>以工作区划分记忆容器，人为可控的多级自动上下文压缩机制</td>
  </tr>
  <tr>
    <td align="center">🐳<br><b>代码安全沙箱</b><br>Docker 隔离执行，不用担心代码命令破坏系统</td>
    <td align="center">🔌<br><b>多模型供应商兼容</b><br>OpenAI / DeepSeek / MoonShot / Ollama / 自定义供应商任意切换</td>
    <td align="center">🎨<br><b>支持自定义任务流</b><br>卡片化任务流编辑，定制属于您的自动化任务流</td>
  </tr>
  <tr>
    <td align="center">👤<br><b>角色卡支持</b><br>自定义您的助手身份，定制一个独属于您的个人助理</td>
    <td align="center">⚒️<br><b>多协议MCP兼容</b><br>支持多种协议的MCP服务，并且可以自定义您的会话生命周期</td>
    <td align="center">💬<br><b>消息节点化管理</b><br>您可以在任意位置编辑或者删除您已发送的信息，并自动生成新的分支</td>
  </tr>
</table>

---

## 🖥️ 界面速览

<table border="0" cellpadding="6" cellspacing="6" style="border-collapse: collapse; width: 100%;">
  <tr>
    <td align="center" width="50%"><b>聊天界面展示</b><br><img src="./README/source/main-page.png"  style="border-radius: 6px;"></td>
    <td align="center" width="50%"><b>编辑器页面演示</b><br><img src="./README/source/editor-page.png"  style="border-radius: 6px;"></td>
  </tr>
  <tr>
    <td align="center"><b>资源管理页展示</b><br><img src="./README/source/src-page.png"  style="border-radius: 6px;"></td>
    <td align="center"><b>设置页展示</b><br><img src="./README/source/setting-page.png"  style="border-radius: 6px;"></td>
  </tr>
</table>

---

## 🚀 快速开始

### 一键安装攻略

对于windows用户，我们使用powershell:

```bash
Set-ExecutionPolicy Bypass -Scope Process -Force
.\setup.ps1
```

对于macos和linux，我们使用命令行终端:

```bash
chmod +x setup.sh
./setup.sh
```

> 一键安装过程中请确保网络保持畅通

### 方式二：Docker Compose 一键启动（推荐）

如果您希