marvin

环境要求

• Python 环境（marvin 是 Python 库）
• uv 包管理器（README 使用 uv add 安装）
• 一个可用的 LLM 提供方 API Key，默认使用 OpenAI
• 可访问外网以调用模型接口

安装与启动步骤

1. 1准备 Python 项目

   marvin 是 Python 库，README 通过 uv add 安装，需先在项目目录中初始化 Python 项目环境并确认 uv 可用。

2. 2安装 marvin

   在项目目录执行安装命令，uv 会把 marvin 写入项目依赖并下载安装。

   uv add marvin

   复制

3. 3配置模型密钥

   Marvin 默认使用 OpenAI，需设置 OPENAI_API_KEY 环境变量，把示例值换成你自己的真实密钥。

   export OPENAI_API_KEY=sk-xxxxxxxx

   复制

4. 4运行第一个任务

   调用 marvin.run 让模型执行一个简单任务，能打印出结果说明安装和密钥配置成功。

   python -c "import marvin; print(marvin.run('Write a short poem about artificial intelligence'))"

   复制

5. 5尝试结构化输出

   通过 result_type 指定返回类型，让模型直接返回 Python 原生类型，验证结构化输出能力。

   python -c "import marvin; print(marvin.run('the answer to the universe', result_type=int))"

   复制

6. 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'))"

   复制

关键配置

如何确认成功

运行 marvin.run 能正常打印出诗句，再执行 result_type=int 的例子输出 42，即表示安装与密钥配置成功。

常见问题

注意事项

• API Key 属于敏感信息，不要写进代码或提交到 Git 仓库。
• 所有示例都需要联网调用大模型接口，无网络时会失败。
• README 未提供 pip 安装、端口或 Docker 部署说明，本教程仅覆盖库安装与代码调用。