alang.ai

在 MacOS 安装 fabric ​

目录

以下步骤告诉你，如何在 MacOS 安装 fabric并使用 fabric client。

0. 前置条件 ​

python 3.10 以上 ​

你需要安装有 Python 3.10 以上。可以用如下命令查询：

bash
python3 --version
//Python 3.11.6

pipx 包管理软件 ​

安装 fabric 将使用 pipx。如果没有，可使用如下命令安装：

bash
brew install pipx

当你使用 pipx 安装一个应用程序时，它会在系统级的某个特定位置（通常是用户的主目录下的 ~/.local/bin 目录）创建一个包含该应用程序及其所有依赖的独立环境。

1. 安装 fabric ​

下载代码 ​

在你的代码文件夹中，从 Github 下载代码：

bash
cd /where/you/keep/code
git clone https://github.com/danielmiessler/fabric.git

用 pipx 安装 fabric ​

bash
cd fabric
pipx install .

这个命令在隔离环境中安装当前目录下 Python 包，其中的 .表示当前目录。

运行结果：

Installing to existing venv 'fabric'
  installed package fabric 1.2.0, installed using Python 3.12.4
  These apps are now globally available
    - fabric
    - fabric-api
    - fabric-webui
    - save
    - ts
    - yt
done! ✨ 🌟 ✨

你可以运行如下命令查看：

bash
fabric --help

或

bash
which fabric
//  /Users/myaccount~/.local/bin/fabric

运行 setup ​

bash
fabric --setup

这里你将被要求填写 OpenAI、Claude、Google、YouTube API key，我们都暂时跳过。

我们这里将安装缺省的 Pattern，你看到如下输出：

Updating patterns...
Downloaded zip file successfully.
Extracted zip file successfully.
Patterns updated successfully.
Creating empty environment file...
Environment file created.

我们的配置文件在：~/.config/fabric，目录如下：

.
├── .env
├── fabric-bootstrap.inc
└── patterns
    ├── agility_story
    │   ├── system.md
    │   └── user.md
...

之后，我们的定制 Pattern 也安装在这个目录下。

其中，fabric-bootstrap.inc 中设置了一系列的 alias。

由于我们没有配置任何的 API key，现在 .env 文件如下：

#No API key set

重启 shell，让 alias 生效 ​

bash
source ~/.zshrc

2. 配置 API ​

如果你直接使用 OpenAI API，你可以直接：

export OPENAI_API_KEY="YOUR TOKEN"

我们这里将使用 OpenRouter 的 API，并修改~/.config/fabric/.env如下：

DEFAULT_MODEL=anthropic/claude-3.5-sonnet
OPENAI_BASE_URL=https://openrouter.ai/api/v1
OPENAI_API_KEY=你的KEY
FABRIC_OUTPUT_PATH=~/notes/fab

我们运行：

source ~/.config/fabric/.env

更新安装 ​

  1. git clone

  2. 运行如下命令

# From the fabric directory
pipx install . --force
fabric --update

3. 尝试使用 ​

我们在一个工作目录中尝试运行，假设这个目录是~/notes/fab。

在该文件夹中，我们放入如下文档片段：paul-superlinear.md，为改文章开头：

One of the most important things I didn't understand about the world when I was a child is the degree to which the returns for performance are superlinear.

Teachers and coaches implicitly told us the returns were linear. "You get out," I heard a thousand times, "what you put in." They meant well, but this is rarely true. If your product is only half as good as your competitor's, you don't get half as many customers. You get no customers, and you go out of business.

It's obviously true that the returns for performance are superlinear in business. Some think this is a flaw of capitalism, and that if we changed the rules it would stop being true. But superlinear returns for performance are a feature of the world, not an artifact of rules we've invented. We see the same pattern in fame, power, military victories, knowledge, and even benefit to humanity. In all of these, the rich get richer. [1]

You can't understand the world without understanding the concept of superlinear returns. And if you're ambitious you definitely should, because this will be the wave you surf on.

拷贝文章内容到剪贴板，然后运行： ​

bash
pbpaste | fabric --pattern summarize

pbpaste获取剪贴板，然后通过 linux 的管道操作符 | 传递给 fabric。它将调用我们配置好的 LLM 运行。

结果如下：

ONE SENTENCE SUMMARY:
Superlinear returns for performance are a fundamental feature of the world, impacting various aspects of life and success.

MAIN POINTS:
1. As a child, the author didn't understand the superlinear nature of performance returns.
2. Teachers often incorrectly implied that returns for effort were linear.
3. In business, slightly inferior products can lead to complete failure, not proportional success.
4. Superlinear returns are not just a capitalist concept but a feature of the world.
5. This pattern is observed in fame, power, military victories, knowledge, and societal benefit.
6. The "rich get richer" phenomenon is a result of superlinear returns.
7. Understanding superlinear returns is crucial for comprehending the world.
8. Ambitious individuals should particularly grasp this concept to leverage it.
9. Superlinear returns act as a "wave" that ambitious people can surf on.
10. This principle challenges the common "you get out what you put in" mentality.

TAKEAWAYS:
1. Recognize that effort and results are not always proportionally related.
2. Small performance differences can lead to dramatically different outcomes.
3. Superlinear returns apply to various aspects of life, not just business.
4. Understanding this concept is crucial for ambitious individuals seeking success.
5. The world naturally favors exponential growth in performance and results.

用 cat 命令直接读取文件 ​

bash
cat paul-superlinear.md | fabric --pattern summarize

我们也可以使用流式输出：

bash
cat paul-superlinear.md | fabric --stream --pattern summarize

我们可以用它的 save 命令来输出，它将被输出到在环境变量中设定的FABRIC_OUTPUT_PATH=~/notes/fab

bash
cat paul-superlinear.md | fabric --stream --pattern summarize | save "paul-summary"

内容被保存在文件：2024-07-12-paul-summary.md

下载youtube 视频脚本并总结 ​

bash
yt 'https://www.youtube.com/watch?v=Evg4HXvsYVY' | fabric -sp summarize | save "Anthropic-Meta-Prompt"

这里使用了 yt 命令。

我们将 --stream --pattern 简写为 -sp

这里，你将需要 YouTube API。如果没有，请按如下获取：

获取 YouTube API
  1. 去到 Google Developers Console https://console.cloud.google.com/
  2. 创建一个项目（Project）
  3. 在 APIs & Services 搜索 "YouTube Data API v3"，并允许
  4. 拷贝这个项目的 API key，并在 Fabric 中配置。

Alang.AI - Make Great AI Applications

Copyright © 2025