Fantasy

使用 Go 语言构建 AI Agent。多供应商、多模型，统一 API。🧙

1. 选择模型和供应商
2. 添加工具
3. 编译为原生机器码，运行起来

import "charm.land/fantasy"
import "charm.land/fantasy/providers/openrouter"

// 选择你最喜欢的供应商。
provider, err := openrouter.New(openrouter.WithAPIKey(myHotKey))
if err != nil {
	fmt.Fprintln(os.Stderr, "Whoops:", err)
	os.Exit(1)
}

ctx := context.Background()

// 选择你最喜欢的模型。
model, err := provider.LanguageModel(ctx, "moonshotai/kimi-k2")
if err != nil {
	fmt.Fprintln(os.Stderr, "Dang:", err)
	os.Exit(1)
}

// 创建你自己的工具。
cuteDogTool := fantasy.NewAgentTool(
  "cute_dog_tool",
  "Provide up-to-date info on cute dogs.",
  fetchCuteDogInfoFunc,
)

// 为你的 Agent 配备装备。
agent := fantasy.NewAgent(
  model,
  fantasy.WithSystemPrompt("You are a moderately helpful, dog-centric assistant."),
  fantasy.WithTools(cuteDogTool),
)

// 让 Agent 开始工作！
const prompt = "Find all the cute dogs in Silver Lake, Los Angeles."
result, err := agent.Generate(ctx, fantasy.AgentCall{Prompt: prompt})
if err != nil {
    fmt.Fprintln(os.Stderr, "Oof:", err)
    os.Exit(1)
}
fmt.Println(result.Response.Content.Text())

🍔 欲查看完整实现及更多内容，请访问 examples 目录。

多模型？多供应商？

是的！Fantasy 的设计初衷是在统一的 API 下支持广泛的供应商和模型。虽然像 Microsoft Azure、Amazon Bedrock 和 OpenRouter 等许多供应商在 Fantasy 中拥有专用包，但其他许多供应商也可以通过 openaicompat（即通用的 OpenAI 兼容层）完美运行。话虽如此，如果您发现某个供应商不兼容且需要特殊处理，请通过提交 Issue（或提交 PR）告知我们。

开发进度

我们构建 Fantasy 是为了驱动 Crush，这是一个用于实现极佳开发体验的硬核编码 Agent。鉴于此，Fantasy 尚不支持以下功能：

• 图像模型
• 音频模型
• PDF 上传

如果您希望看到某些功能得到支持，欢迎提交 PR。

你怎么看？

我们非常期待听到你对该项目的想法。需要帮助吗？我们随时为你提供支持。你可以通过以下方式找到我们：

• Slack
• Discord
• Twitter
• The Fediverse
• Bluesky

---

Charm 的一部分。

Charm热爱开源 • Charm loves open source