# agent_society

**Repository Path**: duzc2/agent_society

## Basic Information

- **Project Name**: agent_society
- **Description**: 系统提供最小“能力原语 + 运行时”，组织规则由智能体自组织生成；同时系统在关键原语处做必要的硬约束，避免组织结构失控。
- **Primary Language**: NodeJS
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 21
- **Forks**: 10
- **Created**: 2026-01-06
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: ai

**Tags**: None

## README

# Agent Society

> 自组织多智能体协作框架

Agent Society 是一个基于大语言模型的智能体协作系统。不同于传统的固定工作流，Agent Society 中的智能体可以像人类一样自主建立组织、分配任务、协作完成复杂目标。
---

![Agent Society UI](docs/images/首页.png)

## 核心特性

- **自组织** - 智能体自主创建岗位、分配任务、建立协作关系，无需预置组织结构
- **多模型支持** - 同时连接多个 LLM 服务，根据任务智能选择最合适的模型
- **异步协作** - 智能体通过消息通信，支持并行处理与复杂协作模式
- **Web 界面** - 内置仿微信风格的可视化界面，实时查看对话和组织结构
- **模块化扩展** - 动态加载外部模块，扩展工具能力和 Web 组件

---


![Agent Society 输入需求](docs/images/输入需求.png)
![Agent Society work](docs/images/work.png)

### 记事本操作

点击查看视频：

[![记事本操作](docs/video/记事本操作.jpg "点击观看")](docs/video/记事本操作.mp4)

### 软件研发团队

点击查看视频：

[![软件团队](docs/video/软件团队.jpg "点击观看")](docs/video/软件团队.mp4)

### 浏览器开发者工具调用

点击查看视频：


[![获取网页控制台](docs/video/获取网页控制台.jpg "点击观看")](docs/video/获取网页控制台.mp4)

### 视频生成和剪辑

点击查看视频：

[![视频生成和剪辑](docs/video/视频生成和剪辑2.jpg "点击观看")](docs/video/视频生成和剪辑.mp4)


### 即时生成UI

点击查看视频：

[![打地鼠](docs/video/打地鼠.jpg "点击观看")](docs/video/打地鼠.mp4)


### 天气挂件即时生成


![天气挂件需求](docs/images/天气挂件需求.png)
![天气挂件需求](docs/images/天气挂件效果.png)

### 组织架构

![组织架构](docs/images/组织架构.png)


---

### 更多样例

![Agent Society 查天气](docs/images/查天气.png)

![Agent Society 推荐旅游路线](docs/images/推荐旅游路线.png)

![Agent Society 推荐旅游路线报告HTML内容](docs/images/推荐旅游路线报告HTML内容.png)

## 快速开始

### 环境要求

- [Bun](https://bun.sh/) >= 1.0（推荐）或 Node.js >= 18
- 兼容 OpenAI API 的 LLM 服务

### 安装

```bash
git clone https://gitee.com/duzc2/agent_society.git
cd agent_society
bun install
```


### 启动

```bash
bun start
```

启动后会自动打开浏览器访问 Web 界面（`http://localhost:3000`）。

---


## 使用方式

启动系统后，直接在浏览器里像微信一样与智能体对话：

1. 向 Root 智能体提出需求
2. 观察智能体自主拆解任务、创建子智能体
3. 实时查看智能体之间的协作过程
4. 随时介入对话，与智能体互动

---

## 系统工作方式

```
用户
 │
 ▼
Root 智能体 —— 分析需求，拆解任务
 │
 ├──────┬──────┐
 ▼      ▼      ▼
智能体A  智能体B  智能体C
 │        │
 ▼        ▼
智能体D  智能体E
```

1. **用户**向 Root 智能体提出需求
2. **Root**分析需求，决定是否需要创建子智能体
3. **子智能体**独立执行任务，必要时继续创建下级智能体
4. **结果汇总**后返回给用户

每个智能体只掌握完成任务所需的最小上下文，复杂任务通过工作区和消息传递协作完成。

---

## 配置

第一次登录网页后会弹出设置界面，如果需要手动设置，需要编辑配置文件。手动修改配置文件后需要重新启动服务器才能加载。

1. 复制配置文件模板：

```bash
cp config/app.json config/app.local.json
cp config/llmservices.json config/llmservices.local.json
```

2. 编辑 `config/app.local.json`，配置你的 LLM 服务：

```json
{
  "llm": {
    "baseURL": "http://127.0.0.1:1234/v1",
    "model": "your-model-name",
    "apiKey": "your-api-key"
  }
}
```
---
### 配置多模型服务

可以为不同岗位配置不同的 LLM 服务：

```json
{
  "services": [
    {
      "id": "gpt4",
      "name": "GPT-4",
      "baseURL": "https://api.openai.com/v1",
      "model": "gpt-4",
      "apiKey": "sk-...",
      "capabilityTags": ["reasoning", "coding"]
    },
    {
      "id": "local",
      "name": "本地模型",
      "baseURL": "http://localhost:1234/v1",
      "model": "qwen2.5-7b",
      "apiKey": "any",
      "capabilityTags": ["chat", "fast"]
    }
  ]
}
```

系统会根据岗位提示词自动选择最合适的模型，也可以手动指定。

---

### 扩展模块

通过模块扩展系统能力：

- **chrome** - 控制 Chrome 浏览器，实现网页自动化
- **ssh** - SSH 远程连接，操作远程服务器

在 `config/app.local.json` 中启用：

```json
{
  "modules": {
    "chrome": { "headless": false },
    "ssh": { "enabled": true }
  }
}
```

---

## 文档

- [快速入门指南](./docs/getting-started.md) - 详细安装配置说明
- [配置指南](./docs/configuration.md) - 配置项详解
- [工具参考](./docs/tools.md) - 可用工具列表
- [开发者参考](./DEV.md) - 开发者参考
---

## 开源协议

本项目采用 [Apache License 2.0](./LICENSE) 开源协议。

```
Copyright 2025 Agent Society Contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

---

<p align="center">
  <a href="https://gitee.com/duzc2/agent_society">Gitee</a> •
  <a href="./docs/getting-started.md">文档</a> •
  <a href="./LICENSE">许可证</a>
</p>