用 Python 装饰器，让任意函数秒变 AI 能力
Marvin 是一个面向 Python 的“环境智能”库，旨在将大语言模型（LLM）的能力无缝嵌入日常代码，让开发者无需复杂提示工程即可构建 AI 驱动的功能。它解决的核心问题是：传统 LLM 集成需要繁琐的 API 调用、提示管理和输出解析，而 Marvin 通过声明式 API 和类型注解，让模型自动完成文本分类、实体提取、数据生成、图像理解等任务。其核心能力包括：基于 Pydantic 的强类型输出（确保结构化结果）、内置函数装饰器（将普通函数升级为 AI 函数）、多模态支持（文本与图像）、以及异步和流式处理。Marvin 还提供简洁的 DSL（领域特定语言），降低使用门槛，适合快速原型和生产级应用。它强调“环境智能”理念，即 AI 作为背景能力，自动响应上下文，减少显式交互。项目活跃，文档完善，但依赖外部模型 API（如 OpenAI），需配置密钥。
1准备 Python 项目
marvin 是 Python 库，README 通过 uv add 安装，需先在项目目录中初始化 Python 项目环境并确认 uv 可用。
2安装 marvin
在项目目录执行安装命令，uv 会把 marvin 写入项目依赖并下载安装。
uv add marvin3配置模型密钥
Marvin 默认使用 OpenAI，需设置 OPENAI_API_KEY 环境变量，把示例值换成你自己的真实密钥。
export OPENAI_API_KEY=sk-xxxxxxxx4运行第一个任务
调用 marvin.run 让模型执行一个简单任务，能打印出结果说明安装和密钥配置成功。
python -c "import marvin; print(marvin.run('Write a short poem about artificial intelligence'))"5尝试结构化输出
通过 result_type 指定返回类型，让模型直接返回 Python 原生类型，验证结构化输出能力。
python -c "import marvin; print(marvin.run('the answer to the universe', result_type=int))"6测试信息抽取
使用 marvin.extract 从非结构化文本中抽取指定类型的数据，可按需附加 instructions 约束。
python -c "import marvin; print(marvin.extract('i found $30 on the ground and bought 5 bagels for $10', int, instructions='only USD'))"| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 是 | OpenAI 密钥，Marvin 默认用它调用模型 | sk-xxxxxxxx |
运行 marvin.run 能正常打印出诗句，再执行 result_type=int 的例子输出 42，即表示安装与密钥配置成功。
Q：必须使用 OpenAI 吗？
A：不是。Marvin 默认使用 OpenAI，但原生支持所有 Pydantic AI 模型，可切换到其他提供方。
Q：没有 uv 怎么安装？
A：README 只给出了 uv add marvin 这一安装方式，可先按 uv 官方文档安装 uv 再执行该命令。
Q：怎样拿到结构化结果而不是纯文本？
A：在 marvin.run 中传入 result_type 指定目标类型（如 int），或使用 cast、extract、classify 等工具。
Q：如何限制抽取范围？
A：在 extract 等调用中通过 instructions 参数传入额外约束，例如只提取美元金额。
LangChain、Semantic Kernel、Outlines
marvin 是智能体领域的开源项目，由 PrefectHQ 开发，2023 年首次发布。
在全站 13,014 个收录项目中，它的 GitHub 星标数（6,198）位列前 8%，在智能体分类的 2,499 个项目里位列前 8%。
项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。开源库，Apache-2.0 许可证，完全免费，可自行部署使用。
它主要面向的使用场景是：快速构建文本分类、情感分析等NLP流水线。同类可对比的替代方案包括 LangChain、Semantic Kernel、Outlines。
下一篇：TaskWeaver
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望，让交互更真实
独立、可自托管的 AI 动态心智状态引擎：驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木，拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工，交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
EvoAgentX
开源
让 AI 智能体自己迭代变强，越用越聪明
EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents