Mirascope

欢迎使用 Mirascope，它允许你通过一个统一的接口调用任何前沿 LLM。

快速入门

安装 Mirascope：

uv add "mirascope[all]"

使用装饰器调用 LLM

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())

获取结构化输出

from pydantic import BaseModel
from mirascope import llm


class Book(BaseModel):
    title: str
    author: str


@llm.call("anthropic/claude-sonnet-4-5", format=Book)
def recommend_book(genre: str):
    return f"Recommend a {genre} book."


book = recommend_book("fantasy").parse()
print(f"{book.title} by {book.author}")

使用工具（Tools）构建 Agent

from pydantic import BaseModel
from mirascope import llm


class Book(BaseModel):
    title: str
    author: str


@llm.tool
def get_available_books(genre: str) -> list[Book]:
    """Get available books in the library by genre."""
    return [Book(title="The Name of the Wind", author="Patrick Rothfuss")]


@llm.call("anthropic/claude-sonnet-4-5", tools=[get_available_books], format=Book)
def librarian(request: str):
    return f"You are a librarian. Help the user: {request}"


response = librarian("I want a fantasy book")
while response.tool_calls:
    response = response.resume(response.execute_tools())
book = response.parse()
print(f"Recommending: {book.title} by {book.author}")

如需了解流式传输（Streaming）、异步（Async）、多轮对话等更多功能，请查看完整文档。

Monorepo 结构

本项目采用 Monorepo 架构，在概念上分为四个部分：

• python/：包含 Python 实现及示例（位于 python/examples）
• typescript/：包含 TypeScript 实现及示例（位于 typescript/examples）
• website/：包含营销网站（文档、博客、落地页）
• docs/：包含跨语言的统一文档（位于 docs/content），以及构建文档所需的配置

有关代码库结构、架构和设计决策的详细信息，请参阅 STRUCTURE.md。

开发网站

使用 bun run website:dev 启动开发服务器。

请注意，必须安装 Bun。

CI 与本地测试

我们目前有四个 CI 任务：

• codespell：检查 Python、TypeScript 和文档仓库中的常见拼写错误
• python-lint：Python 代码的 Linting 和类型检查
• typescript-lint：TypeScript 代码的 Linting 和类型检查
• cloudflare docs build：构建并预览文档网站

你可以在根目录下运行 bun run ci 来在本地执行所有 CI 检查。如果向 GitHub CI 添加了新的检查，请同时将其添加到根目录 package.json 中的 ci 脚本中。

版本控制

Mirascope 使用语义化版本控制 (Semantic Versioning)。

许可证

本项目采用 MIT License 授权。