Metadata-Version: 2.4
Name: magic-tool
Version: 0.1.2
Summary: 占位包：Magic-tool 命令行工具（即将推出）
Author-email: wxd123 <wxd123@users.noreply.github.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/wxd123/magic-tool
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.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# magic-tool
Magic 生态工具

[![PyPI version](https://badge.fury.io/py/magic-tool.svg)](https://badge.fury.io/py/magic-tool)
[![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/)

> 统一 Magic 生态工具入口

## 项目状态

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

## 功能规划

- **项目初始化**：`magic init <project-name>` 一键生成项目结构
- **示例配置**：`magic init --example <config>` 生成 Pipeline 示例文件
- **运行 Pipeline**：`magic run --config pipeline.yaml` 执行编排流程
- **模板管理**：`magic list` 查看可用模板
- **统一入口**：整合 magic-pipeline、magic-coder、magic-api-server 等所有命令

## 功能模块-pipeline

- `llm_generate` - 调用本地 LLM 生成文本（支持 Ollama）
- `generate_stream` - 流式生成文本

## 安装

```bash
pip install magic_tool
```
## 快速示例

```python
from magic_tool.pipeline.model import llm_generate
print(llm_generate("Hello!"))
```

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

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

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

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

## 许可证
MIT License

## 作者
wxd123 - GitHub
