mirascope

环境要求

• 已安装 Python（README 标注支持多版本，具体见 PyPI 页面）
• 已安装 uv 包管理工具（README 的安装命令基于 uv）
• 调用云端大模型所需的该厂商 API Key

安装与启动步骤

1. 1安装 Mirascope

   README 指定的安装命令，[all] 表示安装全部可选依赖，请在项目目录下执行。

   uv add "mirascope[all]"

   复制

2. 2配置 API Key

   调用云端 LLM 前需准备对应厂商的 API Key，并按厂商约定写入环境变量后再运行代码。

3. 3编写调用代码

   使用 @llm.call 装饰器声明模型，函数返回值即 Prompt，调用后通过 text() 取文本结果。

   from mirascope import llm
   
   
   @llm.call("anthropic/claude-sonnet-4-5")
   def recommend_book(genre: str):
       return f"Recommend a {genre} book."
   
   
   response = recommend_book("fantasy")
   print(response.text())

   复制

4. 4运行脚本

   将上一步代码保存为 .py 文件后执行，文件名可自定义，注意与保存路径一致。

   python main.py

   复制

如何确认成功

终端打印出模型返回的书籍推荐文本（response.text() 的内容），即表示调用成功。

常见问题

注意事项

• README 仅给出 uv 安装方式（uv add "mirascope[all]"），未提供 pip 安装命令。
• README 未列出具体的环境变量名、端口或配置项，API Key 相关设置请以各模型厂商文档为准。
• Mirascope 定位为轻量「反框架」，强调用原生 Python 与类型提示直接调用 LLM，替换或调试成本较低。
• README 节选中结构化输出示例代码被截断，完整示例请参考官网文档。