Skip to main content

multimoda Agent framework

Project description

🤖 HyperAgent

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

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


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

✨ 功能特性

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

📦 安装

环境要求

  • 🐍 Python >= 3.12

安装步骤

  1. 📥 克隆项目:

    pip install hyperagent
    

    or

    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 文件。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

hyperagent-0.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (1.6 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

hyperagent-0.0.3-cp313-cp313-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

hyperagent-0.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (815.9 kB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

hyperagent-0.0.3-cp312-cp312-macosx_11_0_arm64.whl (543.1 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

File details

Details for the file hyperagent-0.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for hyperagent-0.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 54671a918829cd034ed4fe9f3593ef59212fd30617d1fd7456f2529077334413
MD5 283eac8855717df071a3ed1b3b1488c4
BLAKE2b-256 716a826e64dfe8eb6574a00a7832dc7646cb559ff4cdf617f1dee57d2097f665

See more details on using hashes here.

File details

Details for the file hyperagent-0.0.3-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for hyperagent-0.0.3-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 f5817f37f245da1e4a149dd93d4724685b6ca4a623090f1ade9dd5d2857bce07
MD5 e8a70a6fea48588f9c59ee14272aaecf
BLAKE2b-256 7e8f6a9ed9d6b7da8f43efd16ad035276e9628bd9b53d1400a3b44a2948927fd

See more details on using hashes here.

File details

Details for the file hyperagent-0.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for hyperagent-0.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a4fb4358ade854f3f729afbe274b8591e31c8eb14c4389160e1fe4ffa0fd625c
MD5 87487bcfbcacd2bf9b732ebb959539a7
BLAKE2b-256 872d13f61e49e2e774e99ea22430b5c68d835f073eb893304eb2873e9f729bb3

See more details on using hashes here.

File details

Details for the file hyperagent-0.0.3-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for hyperagent-0.0.3-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c0f075bb30b07cbb261d22fb9b769802a921b3864ea53743433233075165c474
MD5 0646020bbf05fa104f0b7865dad171d4
BLAKE2b-256 59069369a43e93095406f2d0cfcd71f2b155048582a11ed464fbe6a84aaf5193

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page