redwood (Douglas Gibbons)

🌲 红木

红木 是一个功能强大、高度可配置的CLI和GUI客户端，适用于谷歌的Gemini模型，专注于透明度和用户控制。它与 模型上下文协议（MCP） 使用自定义工具和数据源扩展其功能。

______________________________________________________________________

✨ 特性

• 🖥️ 双接口：在光滑的 平坦的 GUI和传统的终端CLI。

The Redwood GUI

The Redwood CLI

• 🛠️ MCP本地：无缝地将MCP工具用于web抓取、文件管理等任务。
• 🎨 图像生成：通过MCP内置对图像生成模型的支持。
• 🧠 完全提示控制：通过单个配置文件完全控制系统提示。
• 📝 技能整合：具备阅读和运用专业知识的能力 代理技能.
• 🗄️ 永久存储：用于存储用户定义数据和列表的集成数据库。

______________________________________________________________________

🚀 快速开始

1.先决条件

确保你有 uv 安装：

Mac用户：

brew install uv

Linux用户：

curl -LsSf https://astral.sh/uv/install.sh | sh

2.启动Redwood

您可以直接运行Redwood，而无需克隆存储库：

运行GUI：

uvx --from git+https://github.com/douglas-gibbons/redwood gui

…或运行CLI：

uvx --from git+https://github.com/douglas-gibbons/redwood cli

3.配置

第一次运行时，Redwood会在以下位置创建一个配置文件 ~/.config/redwood/redwood.yaml 并提示您输入Gemini API密钥，该密钥将添加到文件中。

您可以在此文件中配置Redwood的任何方面，也可以让Gemini（通过Redwood）为您完成。

______________________________________________________________________

🛠️ 包含的工具

Redwood捆绑了几个核心MCP功能：

• 图像生成：将生成的图像保存到本地目录以便于访问。
• 代理：允许并行任务管理的子代理工具。
• 通用应用程序:

- 时间：提供当前日期和时间上下文。 - 外壳：安全运行本地命令。 - Web剪贴器：从网络中提取内容。 - 技能读物：为特定工作流程加载基于标记的技能。

• 数据库：一个简单的键值存储。您可以提示模型将其用于持久列表（例如，“将牛奶添加到我的购物清单中”）。

______________________________________________________________________

💡 专业建议

设置工作目录

模型不会自动知道您的当前目录。使用 /location 命令行界面（CLI）中的命令来设置您的工作目录。这将当前路径注入到提示符中，从而启用相对文件操作。

可视化工具

GUI具有一个专用窗格，用于实时监控MCP工具交互，为代理的思维过程提供透明度。

______________________________________________________________________

🛠️ 发展

需求

• Python与 uv (brew install uv)
• make (brew install make)

本地设置

git clone https://github.com/douglas-gibbons/redwood.git
cd redwood

有用的命令

• 运行CLI: make cli
• 运行服务器: make server
• 运行测试: make test
• 检查MCP: npx @modelcontextprotocol/inspector make server

______________________________________________________________________

🤝 贡献

欢迎投稿！请随时提交Pull Request或打开问题。

1. 分叉存储库。
2. 创建功能分支(git checkout -b feature/amazing-feature).
3. 提交您的更改(git commit -m 'Add some amazing feature').
4. 打开拉取请求。

______________________________________________________________________

*由道格拉斯·吉本斯创作*

______________________________________________________________________

*免责声明：这不是谷歌的官方项目。这是一个由Douglas Gibbons维护的开源项目。*