Metadata-Version: 2.4
Name: magic-agents
Version: 0.1.0
Summary: 占位包：Magic-agents Agent管理平台）
Author-email: wxd123 <wxd123@users.noreply.github.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/wxd123/magic-agents
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# magic-agents
集中agent 管理平台

[![PyPI version](https://badge.fury.io/py/magic-agents.svg)](https://badge.fury.io/py/magic-agents)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

> 集中agent 管理平台

## 项目状态

**开发中** - 首个正式版本将于 2026 年 Q3 发布

## 功能规划

### 核心能力
- **Agent 注册中心**：统一管理所有 Agent 的元数据、能力描述、健康状态
- **统一调用网关**：标准化调用接口，支持同步/异步、重试、熔断、限流
- **工作流编排引擎**：YAML 定义多 Agent 协作，支持顺序/分支/循环/并行
- **审计与日志**：全链路操作审计，结构化日志，支持合规追溯
- **安全与 IAM**：JWT 认证、API Key 管理、RBAC 权限、租户隔离
- **存储管理**：Agent 元数据、工作流定义、执行实例、审计日志持久化

### 可选能力
- **沙箱执行**：安全隔离执行不可信代码（文件隔离、网络隔离、资源限制）
- **工具注册中心**：原子能力工具的注册与管理（MCP 风格）
- **OA 集成**：对接企业现有 OA/用户系统，统一认证
- **遗留系统适配**：将现有业务系统快速封装为 Agent

### 部署模式
- **私有化部署**：数据不出企业，支持 Linux 服务器
- **轻量起步**：SQLite + Docker Compose，一键部署
- **可扩展**：支持 PostgreSQL，可水平扩展

### 技术特性
- 基于 FastAPI 构建，自动生成 OpenAPI 文档
- 基于 Pydantic 的数据验证
- 结构化 JSON 日志
- 支持 Prometheus 指标暴露
## 安装

```bash
pip install magic_agents
```
## 示例（待正式版本发布后补充）
> 示例代码将在正式版发布时提供。

## 代码规范
本项目遵循以下基本原则：

1. 单文件不超过 200 行：超过时请拆分为多个模块
2. 单函数不超过 200 行：超过时请拆分为多个小函数
3. 注释尽量完整：关键逻辑、复杂算法、非显而易见的代码必须有注释说明
4. 如有特殊场景确实需要突破（如纯数据定义文件），可在 PR 中说明。

这些规则旨在保证代码的可读性和可维护性，便于合作，请尽量遵守。

## 针对 AI 辅助工具的提示
本项目使用 AI 辅助开发，请在生成代码时尽量遵守上述代码规范。

## 许可证
MIT License

## 作者
wxd123 - GitHub
