uAgents

用 Python 快速搭建去中心化多智能体应用

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 357 🐛 待处理 65 👀 关注 26

GitHub ↗

GitHub 星标 ★ 1644

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源框架，Apache-2.0 许可证，完全免费，无付费版本。

项目预览

项目数据

分类智能体

开发团队fetchai

GitHubhttps://github.com/fetchai/uAgents

定价模式🏷️完全免费

价格说明开源框架，Apache-2.0 许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agents,ai,ai-agents,llm,multi-agent-systems

GitHub 星标★ 1644

上线时间2022-09-28 00:00:00

代码更新2026-11-06

仓库体积32.8 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

uAgents 是一个基于 Python 的轻量级去中心化智能体框架，旨在简化多智能体系统的构建与部署。它解决了传统智能体开发中通信复杂、扩展性差的问题，提供简洁的 API 和异步消息传递机制，使开发者能快速创建独立运行的智能体，并通过去中心化网络进行协作。核心能力包括：智能体生命周期管理、消息路由与协议定义、与 LLM 的集成，以及支持自定义行为逻辑。框架强调易用性和性能，适合从原型到生产环境的快速迭代。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1644

技术标签

agents ai ai-agents llm multi-agent-systems

使用教程

难度：入门约 10 分钟部署方式：库/依赖 4 步

环境要求

Python 3.10 至 3.13 环境
可联网的 pip 包管理环境
一个用于保存智能体代码的工作目录

安装与启动步骤

1准备 Python 环境

确认本机 Python 版本在 3.10 到 3.13 之间，低于或高于该范围可能无法安装。
2安装 uAgents

用 pip 从 PyPI 安装 uagents 库，建议在虚拟环境中执行以免污染全局环境。
```
pip install uagents
```
3编写智能体脚本

把 README 示例代码保存为 agent.py，含 Agent 实例和 on_interval 定时任务。
4运行智能体

在 agent.py 所在目录执行脚本，启动后终端会持续输出问候日志。
```
python agent.py
```

关键配置

配置项	必填	说明	示例
`name`	是	智能体名称，用于标识身份并命名本地密钥文件	`alice`
`seed`	否	助记词种子，设置后智能体地址固定不变	`alice recovery phrase`
`ALICE_SEED_PHRASE`	否	通过环境变量传入 seed，避免把助记词写进代码	`alice recovery phrase`
`period`	否	on_interval 装饰器的定时间隔，单位为秒	`2.0`

如何确认成功

运行 python agent.py 后，终端每隔 2 秒输出一条 hello, my name is alice 日志即表示启动成功。

常见问题

Q：不指定 seed 会有什么影响？

A：智能体的私钥会以名称保存在本地 private_keys.json 中；如果连 name 都不传，每次运行都会生成新地址。

Q：支持哪些 Python 版本？

A：README 明确要求 Python 3.10 到 3.13，请使用该范围内的版本安装 uagents。

Q：智能体会自动联网吗？

A：会，启动时智能体会自动在 Fetch.ai 区块链上的 Almanac 合约注册，加入 uAgents 网络。

注意事项

Python 版本须为 3.10~3.13，其他版本未获官方支持。
私钥与消息在框架内经过加密保护，但不要把助记词硬编码进公开仓库。
README 给出的完整示例代码为：from uagents import Agent, Context; alice = Agent(name="alice", seed="alice recovery phrase"); @alice.on_interval(period=2.0) async
要固定地址就显式传 seed，否则每次运行地址可能变化。