幻想

用 Go 构建 AI 助手。多提供商、多模型，一个 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, "哎呀:", err)
	os.Exit(1)
}

ctx := context.Background()

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

// 制作属于你自己的工具。
cuteDogTool := fantasy.NewAgentTool(
  "cute_dog_tool",
  "提供关于可爱狗狗的最新信息。",
  fetchCuteDogInfoFunc,
)

// 为你的助手配备工具。
agent := fantasy.NewAgent(
  model,
  fantasy.WithSystemPrompt("你是一个适度有帮助、以狗狗为中心的助手。"),
  fantasy.WithTools(cuteDogTool),
)

// 让这个助手开始工作吧！
const prompt = "找出洛杉矶银湖地区所有可爱的狗狗。"
result, err := agent.Generate(ctx, fantasy.AgentCall{Prompt: prompt})
if err != nil {
    fmt.Fprintln(os.Stderr, "哎呦:", 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，这是一个用于华丽无敌开发的热门编码助手。因此，Fantasy 目前还不支持以下功能：

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

如果你希望看到这些功能被支持，欢迎提交 PR。

你怎么看？

我们非常期待听到你对这个项目的看法。需要帮助吗？我们随时为你效劳。你可以在以下地方找到我们：

• Slack
• Discord
• Twitter
• Fediverse
• Bluesky

---

Charm 的一部分 Charm。

Charm 热爱开源 • Charm loves open source

Fantasy 快速上手指南

Fantasy 是一个基于 Go 语言构建 AI 智能体（Agent）的开源库。它支持多模型、多提供商，并通过统一的 API 接口让开发者能够轻松编译为原生机器代码运行。

环境准备

• 操作系统：Linux, macOS, Windows
• Go 版本：建议安装 Go 1.21 或更高版本
• 依赖项：
  • 有效的 AI 模型提供商 API Key（如 OpenRouter, Azure, AWS Bedrock 等）
  • 网络连接（用于调用大模型接口）

确保已正确配置 Go 环境变量（GOPATH, GOBIN 等）。

安装步骤

在您的 Go 项目目录中，使用 go get 命令安装 Fantasy 及其依赖：

go get charm.land/fantasy
go get charm.land/fantasy/providers/openrouter

提示：如果访问 charm.land 速度较慢，可尝试配置 Go 代理加速：

export GOPROXY=https://goproxy.cn,direct

基本使用

以下是最小化的使用示例，展示如何创建一个基于 OpenRouter 的 AI 智能体并执行任务。

1. 导入包并初始化提供商

import (
	"context"
	"fmt"
	"os"

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

func main() {
	// 替换为您的实际 API Key
	myHotKey := "YOUR_API_KEY_HERE"

	// 选择提供商 (以 OpenRouter 为例)
	provider, err := openrouter.New(openrouter.WithAPIKey(myHotKey))
	if err != nil {
		fmt.Fprintln(os.Stderr, "Whoops:", err)
		os.Exit(1)
	}

	ctx := context.Background()

	// 选择模型 (例如 moonshotai/kimi-k2)
	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 := fantasy.NewAgent(
		model,
		fantasy.WithSystemPrompt("You are a moderately helpful, dog-centric assistant."),
		fantasy.WithTools(cuteDogTool),
	)

	// 执行任务
	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())
}

2. 运行程序

保存代码为 main.go，然后运行：

go run main.go

3. 编译为原生二进制文件

Fantasy 支持直接编译为高性能的原生可执行文件：

go build -o my-agent main.go
./my-agent

---

更多高级用法和完整示例请参考官方仓库的 examples 目录。