用装饰器把大模型变成普通 Python 函数，调用即得结果
magentic 是一个将 LLM 无缝集成到 Python 函数中的开源库。它解决的是开发者在构建 AI 应用时，需要频繁编写样板代码来调用大模型 API、解析输出、处理结构化数据的问题。通过使用装饰器，magentic 允许开发者直接定义 Python 函数，并在函数体内用自然语言描述逻辑，函数调用时自动将输入转换为提示词，调用 LLM，并将输出解析为指定的 Python 类型（如字符串、列表、Pydantic 模型等）。其核心能力包括：函数装饰器、类型提示驱动的输出解析、支持流式输出、异步调用、以及集成 OpenAI API。它让 AI 能力像普通函数一样被调用，降低了 LLM 应用开发的门槛，提高了代码的可读性和可维护性。
1安装 magentic
README 给出的官方安装命令，用 pip 把 magentic 装进当前 Python 环境。
pip install magentic2或用 uv 安装
如果项目用 uv 管理依赖，可按 README 的方式改用 uv add 添加。
uv add magentic3配置 API Key
设置环境变量 OPENAI_API_KEY，magentic 默认走 OpenAI；Windows 可用 setx 设置。
export OPENAI_API_KEY=sk-xxxxxxxx4验证导入
导入 magentic 检查安装是否成功，无报错即表示库已就绪。
python -c "import magentic"| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 是 | OpenAI API 密钥，magentic 调用 LLM 时用于鉴权 | sk-xxxxxxxx |
执行 python -c "import magentic" 无报错，且环境变量 OPENAI_API_KEY 已生效。
Q：想用其他 LLM 提供商怎么办？
A：README 说明支持多个 backend（如 OpenAI、Anthropic、Ollama），具体配置方式需查看文档 Configuration 章节。
Q：没有 OpenAI API Key 能用吗？
A：可以切换到其他 backend，但需按对应 backend 的要求配置；README 未给出具体步骤，请参考官网文档。
Q：可以用 uv 代替 pip 安装吗？
A：可以，README 同时给出 pip install magentic 与 uv add magentic 两种方式，任选其一。
LangChain、guidance、Outlines
magentic 是开发框架领域的开源项目，由 jackmpcollins 开发，2023 年首次发布。
在全站 13,090 个收录项目中，它的 GitHub 星标数（2,425）位列前 30%，在开发框架分类中处于中上游。
项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-16。MIT许可证，完全免费，可自行部署使用。从国内网络环境看，可直接访问。
它主要面向的使用场景是：快速构建基于自然语言的文本处理工具（如摘要、分类、提取）。同类可对比的替代方案包括 LangChain、guidance、Outlines。
上一篇：LlamaIndexTS
ComfyUI_Custom_Nodes_AlekPet
开源
给 ComfyUI 装上语音翻译和姿态检测，工作流更全能
Custom nodes that extend the capabilities of Comfyui
langchain
开源
组装 AI 应用的乐高积木，从想法到上线不换工具
The agent engineering platform.
transformers
开源
全球最大的模型仓库全家桶，想用的模型一把抓
Transformers: the model-definition framework for state-of-the-art machine learning m···
pi
开源
一套 TypeScript 工具包，快速搭出能写代码的 AI agent
AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI