🤖 HyperAgent

一个强大的多模态智能代理框架

⚡ 特性 • 📦 安装 • 🚀 使用 • 🏗️ 项目结构 • 💡 示例说明 • 📄 许可证

HyperAgent 是一个多模态智能代理框架，旨在创建和管理具有多种技能的智能代理。它支持通过技能扩展代理功能，提供灵活的智能体开发和部署能力。

✨ 功能特性

🧠 多模态智能代理支持 - 支持多种输入输出模式
🔧 可扩展的技能系统 - 通过技能轻松扩展代理功能
🌐 支持 OpenAI API 兼容的模型接口 - 可使用各种 LLM 模型
🛡️ 内置沙箱环境支持 - 安全执行外部代码
⚙️ 可配置的工作流管理 - 灵活配置代理行为

📦 安装

环境要求

🐍 Python >= 3.12

安装步骤

📥 克隆项目：

pip install hyperagent

pip install hyperagent[research]

🚀 使用方法

命令行方式

hyperagent

作为库使用

from hyperagent.agent import create_agent_skill

# 🤖 创建智能代理
agent = create_agent_skill(config)

🧪 运行示例

项目包含示例，位于 examples/agent_skills 目录下：

cd examples/agent_skills
python run.py

⚙️ 配置说明

HyperAgent 支持通过配置文件自定义代理行为。配置文件使用 OmegaConf 格式，支持以下选项：

work_dir: 📁 工作目录
skills_dir: 🔧 技能目录
example_data_dir: 📊 示例数据目录
use_sandbox: 🛡️ 是否使用沙箱环境

🔧 技能系统

HyperAgent 的技能系统允许代理执行特定任务。技能可以包括脚本、文档和资源文件。每个技能包含：

SKILL.md: 📝 技能说明文档
scripts/: 💻 可执行脚本
📁 相关资源文件

🧪 开发

运行测试

# 从项目根目录运行
python -m pytest tests/

🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进项目。

📄 许可证

本项目使用 GPL-3.0 许可证。详情请参见 LICENSE 文件。

Metadata

Release files for hyperagent 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for hyperagent 0.0.3
File	Interpreter	ABI	Platform	Actions Reset
hyperagent-0.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl 1.6 MB Jan 13, 2026 Without provenance	CPython 3.13	CPython 3.13	Linux glibc 2.28+ x86-64, Linux glibc 2.17+ x86-64	Details for hyperagent-0.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
hyperagent-0.0.3-cp313-cp313-macosx_11_0_arm64.whl 1.1 MB Jan 13, 2026 Without provenance	CPython 3.13	CPython 3.13	macOS 11.0+ ARM64	Details for hyperagent-0.0.3-cp313-cp313-macosx_11_0_arm64.whl
hyperagent-0.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl 815.9 kB Jan 13, 2026 Without provenance	CPython 3.12	CPython 3.12	Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64	Details for hyperagent-0.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
hyperagent-0.0.3-cp312-cp312-macosx_11_0_arm64.whl 543.1 kB Jan 13, 2026 Without provenance	CPython 3.12	CPython 3.12	macOS 11.0+ ARM64	Details for hyperagent-0.0.3-cp312-cp312-macosx_11_0_arm64.whl

Total release size: 4.0 MB

Release files / hyperagent-0.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL	hyperagent-0.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size	1.6 MB
Tags	CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum How to use checksums	`54671a918829cd034ed4fe9f3593ef59212fd30617d1fd7456f2529077334413`
BLAKE2b-256 checksum How to use checksums	`716a826e64dfe8eb6574a00a7832dc7646cb559ff4cdf617f1dee57d2097f665`
Upload date	Jan 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Release files / hyperagent-0.0.3-cp313-cp313-macosx_11_0_arm64.whl

Download URL	hyperagent-0.0.3-cp313-cp313-macosx_11_0_arm64.whl
Size	1.1 MB
Tags	CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`f5817f37f245da1e4a149dd93d4724685b6ca4a623090f1ade9dd5d2857bce07`
BLAKE2b-256 checksum How to use checksums	`7e8f6a9ed9d6b7da8f43efd16ad035276e9628bd9b53d1400a3b44a2948927fd`
Upload date	Jan 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Release files / hyperagent-0.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL	hyperagent-0.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size	815.9 kB
Tags	CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum How to use checksums	`a4fb4358ade854f3f729afbe274b8591e31c8eb14c4389160e1fe4ffa0fd625c`
BLAKE2b-256 checksum How to use checksums	`872d13f61e49e2e774e99ea22430b5c68d835f073eb893304eb2873e9f729bb3`
Upload date	Jan 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Release files / hyperagent-0.0.3-cp312-cp312-macosx_11_0_arm64.whl

Download URL	hyperagent-0.0.3-cp312-cp312-macosx_11_0_arm64.whl
Size	543.1 kB
Tags	CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`c0f075bb30b07cbb261d22fb9b769802a921b3864ea53743433233075165c474`
BLAKE2b-256 checksum How to use checksums	`59069369a43e93095406f2d0cfcd71f2b155048582a11ed464fbe6a84aaf5193`
Upload date	Jan 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Security for hyperagent 0.0.3

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.3 This release

Jan 13, 2026 4 release files No provenance

0.0.2

Jan 7, 2026 4 release files No provenance

hyperagent 0.0.3