hyperagent 0.0.2

multimoda Agent framework

🤖 HyperAgent

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

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

---

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

✨ 功能特性

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

📦 安装

环境要求

• 🐍 Python >= 3.12

安装步骤

1. 📥 克隆项目：

   git clone https://github.com/your-repo/HyperAgent.git
   cd HyperAgent
   

2. 🔄 创建虚拟环境（推荐）：

   python -m venv venv
   source venv/bin/activate  # Linux/Mac
   # 或
   venv\Scripts\activate     # Windows
   

3. 📚 安装依赖：

   pip install -e .
   

🚀 使用方法

命令行方式

hyperagent

作为库使用

from hyperagent.agent.agent_skill 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 文件。