Templonix Lite

The Local-First Personal AI Agent Infrastructure

欢迎使用Templonix Lite，这是一个强大而精简的工具包，可增强您使用Claude Desktop的体验。它通过模型上下文协议（MCP）公开了一套工具，包括谷歌服务、网络抓取、本地内存、知识上传和动态工作流，使Claude能够执行复杂的、现实世界的代理任务。

本指南提供了在Windows或Mac上启动和运行项目的所有必要步骤。

架构概述

Templonix Lite充当自定义MCP服务器，扩展了Claude与MCP协议层通信的功能，后者可以将请求路由到本地MCP服务器（如Asana或Google Drive）或您的自定义Templonix服务器。

这种架构允许代理无缝访问各种工具，从标准的SaaS产品到该项目内置的专门功能。

______________________________________________________________________

🎯 选择你的道路

Templonix Lite专为两类用户设计：

______________________________________________________________________

✨ 所得

适合所有人（标准设置）

• 🧠 本地矢量存储器（FAISS） --存储和回忆对话中的信息。使用 /remember 保存事实；问“我跟你说过关于X的什么？”来取回它们。
• 📚 知识库加载器 --将文档放入文件夹中，Templonix会自动为其建立索引以进行语义搜索。
• 🔄 动态工作流程 --加载专家“角色”（销售谈判代表、营销专家等），为克劳德提供专业知识和方法。
• 🔌 原生Claude工具 --使用Claude的内置功能：创建Mermaid图表、Word文档（.docx）、PowerPoint（.pptx）等。
• 🔗 原生SaaS连接器 --通过Claude的官方集成连接谷歌云端硬盘、Gmail（已阅读）、日历（已读取）、Asana、Notion等。

对于高级用户（需要额外设置）

• 📅 日历写入权限 -通过Google日历API创建、更新和删除Google日历事件。
• 📧 电子邮件草稿和发送 -创建Gmail草稿或直接发送电子邮件（通过Gmail API或SMTP）。
• 🌐 Jina AI网页抓取 --可靠地抓取网页，绕过常见的机器人检测和代理问题。需要在以下地点购买代币 Jina AI网站.
• 📊 Eraser.io图表 --根据文本指令生成流程图、序列图和架构图。需要在以下地点购买积分 Eraser.io.
• 🛠️ 可扩展架构 --使用提供的框架构建自己的MCP工具。

______________________________________________________________________

🚀 标准设置（约15分钟）

选择您的操作系统：

• Windows安装程序
• Mac设置

______________________________________________________________________

Windows安装程序

先决条件

在开始之前，请确保您已经：

• Windows 10或11
• Python 3.10、3.11、3.12或3.13 — 从python.org下载
• 克劳德桌面 — 从Anthropic下载
• 已配置Google连接器 --在Claude Desktop中，连接您的Google帐户 Gmail 和 谷歌日历。这允许通过Claude的本地集成以只读方式访问您的电子邮件和日历事件。

注： 你不需要安装Git。我们将以ZIP文件的形式下载代码。

______________________________________________________________________

步骤1：创建项目文件夹

在您的计算机上创建此确切的文件夹路径：

C:\Development\Templonix_Lite

您可以通过以下方式做到这一点：

1. 打开文件资源管理器
2. 引导到 C:\
3. 创建一个名为的新文件夹 Development
4. 内部 Development，创建一个名为的文件夹 Templonix_Lite

______________________________________________________________________

步骤2：下载并提取代码

1. 去
2. 点击绿色 代码 按钮→ 下载ZIP
3. 打开下载的 templonix-lite-master.zip
4. 在ZIP中，您将看到一个名为 templonix-lite-master
5. 复制所有内容 （文件和文件夹）从内部 templonix-lite-master 进入 C:\Development\Templonix_Lite

您的文件夹现在应该看起来像这样：

C:\Development\Templonix_Lite\
├── assets\
├── config\
├── core\
├── infra\
├── templonix_mcp\
├── tests\
├── workflows\
├── bootstrap.ps1
├── bootstrap.sh
├── requirements.txt
├── README.md
└── ... (other files)

______________________________________________________________________

步骤3：运行Bootstrap脚本

这将安装所有必需的依赖项。

1. 打开 PowerShell:

- 按 Win + X 然后选择“Windows PowerShell”或“终端” - 或者在“开始”菜单中搜索“PowerShell”

1. 导航到项目文件夹：

   cd C:\Development\Templonix_Lite

1. 运行引导脚本：

   .\bootstrap.ps1

1. 等待完成（3-5分钟）。您应该看到“Bootstrap完成。准备使用Templonix Lite！”

⚠️ 如果出现“脚本禁用”错误： 请先运行此命令，然后重试： ``powershell Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser ` 类型 Y` 当提示时。

______________________________________________________________________

步骤4：构建并安装扩展

4a。创建您的清单文件

清单文件告诉Claude Desktop如何运行Templonix Lite。我们为Windows和Mac提供了模板，您只需复制正确的模板即可。

1. 打开文件资源管理器并导航到 C:\Development\Templonix_Lite\templonix_mcp
2. 您将看到两个示例文件：

- mcp.windows.example.json ← 用这个 - mcp.mac.example.json

1. 复制 mcp.windows.example.json 和 重命名副本 到 manifest.json

您的文件夹现在应该包含：

templonix_mcp/
├── manifest.json                    ← Your manifest (copied from Windows example)
├── mcp.windows.example.json
├── mcp.mac.example.json
├── app.py
└── ...

可选：个性化设置！ 打开 manifest.json 在记事本中更改：

• "display_name" --Claude Desktop中显示的内容（例如“我的AI助手”）
• "author": { "name": "..." } --写上你自己的名字
• "description" --你自己的描述

进行任何更改后保存文件。

4b。构建扩展包

1. 打开 PowerShell
2. 导航到templonix_mcp文件夹：

   cd C:\Development\Templonix_Lite\templonix_mcp

1. 运行pack命令：

   mcpb pack

这创造了 templonix_mcp.mcpb 在文件夹中。

为什么要自己建造？ 这确保了透明度——您可以检查 manifest.json 配置，并确切地知道正在安装什么。没有神秘的二进制文件！

4c。在Claude桌面中安装

1. 打开 克劳德桌面

1. 点击 文件 → 设置

1. 首选 高级设置 在扩展下

1. 向下滚动并单击 安装扩展

1. 引导到 C:\Development\Templonix_Lite\templonix_mcp

1. 选择文件 templonix_mcp.mcpb （你刚刚创建的那个）

1. 点击 确认 安装

1. 重新启动克劳德桌面

______________________________________________________________________

步骤5：启动时自动启动（可选但推荐）

这使得Templonix Lite在Windows启动时自动启动。

1. 按 Win + R 打开“运行”对话框
2. 类型 shell:startup 然后按Enter键
3. 复制文件 C:\Development\Templonix_Lite\config\start-templonix-silent.vbs 进入此启动文件夹

就是这样！Templonix Lite现在将在您启动计算机时在后台静默运行。

______________________________________________________________________

✅ Windows安装完成！

打开Claude Desktop，单击+符号，查看是否启用了Templonix Lite扩展。

然后让克劳德告诉你可用的工具。

______________________________________________________________________

Mac设置

先决条件

在开始之前，请确保您已经：

• macOS 11（大苏尔）或更高版本
• Python 3.10、3.11、3.12或3.13 — 从python.org下载

- ⚠️ 不支持Python 3.14+（许多依赖项还没有兼容的版本） - 检查您的版本： python3 --version

• 克劳德桌面 — 从Anthropic下载
• 已配置Google连接器 --在Claude Desktop中，连接您的Google帐户 Gmail 和 谷歌日历。这允许通过Claude的本地集成以只读方式访问您的电子邮件和日历事件。

注： 你不需要安装Git。我们将以ZIP文件的形式下载代码。

______________________________________________________________________

步骤1：创建项目文件夹

在您的计算机上创建此文件夹路径：

~/Development/Templonix_Lite

您可以通过以下方式做到这一点：

选项A：使用Finder

1. 打开查找器
2. 按 Cmd + Shift + H 转到主文件夹
3. 创建一个名为的新文件夹 Development
4. 内部 Development，创建一个名为的文件夹 Templonix_Lite

选项B：使用终端

mkdir -p ~/Development/Templonix_Lite

______________________________________________________________________

步骤2：下载并提取代码

1. 去
2. 点击绿色 代码 按钮→ 下载ZIP
3. 打开下载的 templonix-lite-master.zip （它可能会自动解压缩到您的下载文件夹）
4. 在提取的文件夹中，您将看到一个名为 templonix-lite-master
5. 复制所有内容 （文件和文件夹）从内部 templonix-lite-master 进入 ~/Development/Templonix_Lite

您的文件夹现在应该看起来像这样：

~/Development/Templonix_Lite/
├── assets/
├── config/
├── core/
├── infra/
├── templonix_mcp/
├── tests/
├── workflows/
├── bootstrap.ps1
├── bootstrap.sh
├── requirements.txt
├── README.md
└── ... (other files)

______________________________________________________________________

步骤3：运行Bootstrap脚本

这将安装所有必需的依赖项。

1. 打开 终端:

- 按 Cmd + Space，键入“终端”，然后按Enter键 - 或者在应用程序中找到它→ 公用事业→ 终端

1. 导航到项目文件夹：

   cd ~/Development/Templonix_Lite

1. 使引导脚本可执行（仅限一次性）：

   chmod +x bootstrap.sh

1. 运行引导脚本：

   ./bootstrap.sh

1. 等待完成（3-5分钟）。您应该看到“Bootstrap完成。准备构建Templonix。”

⚠️ 如果您收到“拒绝权限”错误： 确保你运行了 chmod +x bootstrap.sh 步骤3中的命令。

⚠️ 如果你得到“python：找不到命令”： 在Mac上，Python 3通常被称为 python3.编辑 bootstrap.sh 文件和更改 python 到 python3，然后再跑一次。

______________________________________________________________________

步骤4：构建并安装扩展

4a。创建您的清单文件

清单文件告诉Claude Desktop如何运行Templonix Lite。我们为Windows和Mac提供了模板，您只需复制正确的模板即可。

1. 打开Finder并导航到 ~/Development/Templonix_Lite/templonix_mcp
2. 您将看到两个示例文件：

- mcp.windows.example.json - mcp.mac.example.json ← 用这个

1. 复制 mcp.mac.example.json 和 重命名副本 到 manifest.json

或通过终端：

cd ~/Development/Templonix_Lite/templonix_mcp
cp mcp.mac.example.json manifest.json

您的文件夹现在应该包含：

templonix_mcp/
├── manifest.json                    ← Your manifest (copied from Mac example)
├── mcp.windows.example.json
├── mcp.mac.example.json
├── app.py
└── ...

重要提示： 打开 manifest.json 在文本编辑器（TextEdit或VS Code）中，并替换 USERNAME 使用您的实际Mac用户名。

要查找您的用户名，请打开终端并键入 whoami.

例如，如果您的用户名是 sarah，更改：

"/Users/USERNAME/Development/Templonix_Lite/.venv/bin/python"

致：

"/Users/sarah/Development/Templonix_Lite/.venv/bin/python"

可选：个性化设置！ 编辑时，您还可以更改：

• "display_name" --Claude Desktop中显示的内容（例如“我的AI助手”）
• "author": { "name": "..." } --写上你自己的名字
• "description" --你自己的描述

更改后保存文件。

4b。构建扩展包

1. 打开 终端
2. 导航到templonix_mcp文件夹：

   cd ~/Development/Templonix_Lite/templonix_mcp

1. 运行pack命令：

   mcpb pack

这创造了 templonix_mcp.mcpb 在文件夹中。

为什么要自己建造？ 这确保了透明度——您可以检查 manifest.json 配置，并确切地知道正在安装什么。没有神秘的二进制文件！

4c。在Claude桌面中安装

1. 打开 克劳德桌面

1. 点击 克劳德 （菜单栏）→ 设置 （或按 Cmd + ,)

1. 首选 高级设置 在扩展下

1. 向下滚动并单击 安装扩展

1. 引导到 ~/Development/Templonix_Lite/templonix_mcp

1. 选择文件 templonix_mcp.mcpb （你刚刚创建的那个）

1. 点击 确认 安装

1. 重新启动克劳德桌面

______________________________________________________________________

步骤5：登录时自动启动（可选）

在Mac上自动启动Templonix Lite有两个选项：

选项A：双击启动器（最简单）

使用提供的 start-templonix.command 需要时手动启动Templonix的文件：

1. 在Finder中，导航到 ~/Development/Templonix_Lite/config
2. 双击 start-templonix.command
3. 如果您看到安全警告，请转到 系统首选项 → 安全与隐私 → click 无论如何打开

您可以将此文件添加到Dock以便于访问。

选项B：登录时自动启动（LaunchAgent）

要使Templonix在您登录时自动启动：

1. 打开终端并运行：

   cp ~/Development/Templonix_Lite/config/com.templonix.lite.plist ~/Library/LaunchAgents/

1. 加载LaunchAgent：

   launchctl load ~/Library/LaunchAgents/com.templonix.lite.plist

要稍后停止自动启动，请执行以下操作：

launchctl unload ~/Library/LaunchAgents/com.templonix.lite.plist
rm ~/Library/LaunchAgents/com.templonix.lite.plist

______________________________________________________________________

✅ Mac安装完成！

打开Claude Desktop，单击+符号，查看是否启用了Templonix Lite扩展。

然后让克劳德告诉你可用的工具。

______________________________________________________________________

🎉 你完了！

打开Claude Desktop并尝试以下命令：

______________________________________________________________________

🔧 高级设置

本节适用于需要电子邮件/日历写入权限、网络抓取或图表生成的用户。适用于Windows和Mac。

1.谷歌API（日历和Gmail写访问）

这使得可以直接从Claude创建日历事件和起草/发送电子邮件。需要谷歌云控制台配置。

📋 Click to expand Google API setup instructions

先决条件

• Google帐户
• 访问 谷歌云控制台

第一步：创建谷歌云项目

1. 首选 谷歌云控制台
2. 点击 选择一个项目 → 新项目
3. 命名它（例如。， Templonix-Lite)然后单击 创建
4. 创建后选择项目

步骤2：启用API

1. 搜索 API库 在控制台中
2. 搜索和 启用 这些API：

- 谷歌日历API - Gmail API

步骤3：配置OAuth同意屏幕

1. 首选 API和服务 → OAuth 同意屏幕
2. 选择 外部的 并填写表格：

- 应用程序名称： Templonix-Lite - 用户支持电子邮件：您的电子邮件 - 联系邮箱：您的邮箱

1. 点击 创建

步骤4：添加测试用户

1. 在OAuth同意屏幕中，转到 观众
2. 在...之下 测试用户，添加您的电子邮件地址
3. 保存

步骤5：创建OAuth凭据

对于日历：

1. 首选 API和服务 → 凭证
2. +创建凭据 → OAuth客户端ID
3. 应用程序类型： 桌面应用程序
4. 姓名： Templonix-Calendar
5. 下载JSON并另存为 credentials.json 在Templonix文件夹中：

- 窗户： C:\Development\Templonix_Lite - 雨衣： ~/Development/Templonix_Lite

对于Gmail：

1. 重复上述步骤
2. 姓名： Templonix-Gmail
3. 下载JSON并另存为 credentials_gmail.json 在同一文件夹中

步骤6：首次身份验证

第一次使用日历或电子邮件工具时，将打开一个浏览器窗口进行OAuth授权。完成流程后，令牌将自动保存。

安装后的文件结构

Templonix_Lite/
├── credentials.json        ← Calendar OAuth config
├── credentials_gmail.json  ← Gmail OAuth config
├── token.json              ← Calendar auth tokens (auto-created)
├── token_gmail.json        ← Gmail auth tokens (auto-created)
└── ...

故障排除

“访问被阻止：此应用程序的请求无效”

• 确保您已配置OAuth同意屏幕
• 验证您的电子邮件是否已添加为测试用户

“应用程序未验证”警告

• 这对于处于测试模式的应用程序来说是正常的
• 点击 高级 → 转到\[应用程序名称\]（不安全） → 继续

令牌刷新错误

• 删除 token.json 或 token_gmail.json 并重新验证

安全说明

切勿将凭据或令牌文件提交到Git。他们已经进去了 .gitignore.

______________________________________________________________________

2.环境变量(.env 文件）

对于高级功能，请创建 .env Templonix文件夹中的文件：

• 窗户： C:\Development\Templonix_Lite\.env
• 雨衣： ~/Development/Templonix_Lite/.env

# ─────────────────────────────────────────────────
# ADVANCED FEATURES (Optional)
# ─────────────────────────────────────────────────

# SMTP Email Sending (requires Google App Password)
# Get an App Password: https://myaccount.google.com/apppasswords
GOOGLE_EMAIL_ADDRESS="your-email@gmail.com"
GOOGLE_EMAIL_PSWD="your-16-character-app-password"
GOOGLE_EMAIL_SMTP_SERVER="smtp.gmail.com"
GOOGLE_EMAIL_MAIL_PORT="587"

# Jina AI Web Scraping
# Get API key: https://jina.ai/
JINA_API_KEY="your-jina-api-key"

# Eraser.io Diagrams
# Get API token from Eraser.io account settings
ERASER_API_TOKEN="your-eraser-api-token"

______________________________________________________________________

🧠 使用Templonix Lite

存储器系统

工作流

"List available workflows"     → See available expert modes
"Load sales_negotiator"        → Activate Sales Negotiation expert mode

知识库

1. 将文档（PDF、TXT、MD、DOCX）放入 knowledge 文件夹：

- 窗户： C:\Development\Templonix_Lite\knowledge - 雨衣： ~/Development/Templonix_Lite/knowledge

1. 请克劳德“加载知识库”或使用 knowledge_load 工具
2. 使用“搜索所有\[主题\]”进行搜索

原生Claude功能（无需额外设置）

Claude Desktop已经提供了这些功能——与Templonix一起使用：

• Google 云端硬盘 --阅读和搜索您的文档
• Gmail --阅读电子邮件和搜索收件箱
• 谷歌日历 --查看即将举行的活动
• Asana、Notion、Slack --通过Claude的集成菜单连接
• 创建文档 --请克劳德创建 .docx, .pptx美人鱼图等。

______________________________________________________________________

📁 项目结构

Templonix_Lite/
├── templonix_mcp/
│   ├── app.py              # Main MCP server
│   └── templonix_mcp.mcpb  # Built by you (created during setup)
├── core/
│   └── tools/              # Email, Calendar, Gmail tools
├── infra/
│   └── memory/             # FAISS memory manager & knowledge loader
├── workflows/              # Expert workflow prompts
├── knowledge/              # Drop documents here for indexing
├── config/
│   ├── start-templonix-silent.vbs   # Windows auto-start
│   ├── start-templonix.command      # Mac double-click launcher
│   └── com.templonix.lite.plist     # Mac LaunchAgent
├── bootstrap.ps1           # Windows setup script
├── bootstrap.sh            # Mac/Linux setup script
├── requirements.txt
└── .env                    # Your configuration (create for advanced features)

______________________________________________________________________

🔍 可用工具参考

核心工具（始终可用）

高级工具（需要额外设置）

______________________________________________________________________

🐛 故障排除

Windows问题

运行bootstrap.ps1时出现“脚本已禁用”错误

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Python无法识别

• 确保Python已安装并添加到PATH
• 试着跑步 python --version 验证

Mac问题

运行bootstrap.sh时“权限被拒绝”

chmod +x bootstrap.sh

“python：找不到命令”

• 在Mac上，试试 python3 而不是 python
• 编辑 bootstrap.sh 和改变 python 到 python3

“找不到命令：pip”

• 使用 pip3 而不是 pip
• 或运行： python3 -m pip install -r requirements.txt

打开.command文件时的安全警告

• 首选 系统首选项 → 安全与隐私 → 将军
• 点击 无论如何打开 在被阻止的应用程序消息旁边

一般问题

克劳德看不到Templonix工具

• 验证 .mcpb 扩展已安装在Claude Desktop中
• 重新启动克劳德桌面
• 检查Templonix服务器是否正在运行

内存搜索未返回任何结果

• 检查 archive_stats 验证条目是否存在
• 尝试更广泛的搜索词

“未找到credentials.json”

• 这只影响高级功能（日历/Gmail写访问）
• 标准功能在没有Google API证书的情况下工作

______________________________________________________________________

🔐 安全注意事项

• 永不承诺 凭证或令牌文件到版本控制
• 所有敏感文件都已在 .gitignore:

  credentials.json
  credentials_gmail.json
  token.json
  token_gmail.json
  .env