Jason AI Toolkit

Jason的人工智能工具包

一个全面的人工智能自动化工具、机器人和配置集合，用于在新机器上快速部署。这个存储库打包了让Jason的AI/自动化基础设施快速运行所需的一切。

目录

• 概述
• 包含什么
• 快速开始
• 先决条件
• 安装
• 项目文件
• 配置
• 故障排除

概述

此工具包包含：

• 自动化机器人：事件跟踪器、住房搜索机器人、投资分析
• AI工具：图书处理、libgen下载器、自动化工作流程
• 代理配置：Agent Deck、OpenClaw、Claude Desktop MCP服务器
• 设置脚本：macOS的一个命令安装

包含什么

机器人(/bots)

1. MattBot -马特·奈特事件跟踪器

- 清除Matt Knight篮球比赛信息的多个来源 - 为即将到来的游戏发送谷歌日历通知 - 包括DuckDuckGo搜索、直接抓取网站 - 作为macOS守护进程运行

1. 到处乱跑 -斯坦福住房自动机

- 监控SUPost.com的住房列表 - 按日期、类型和关键字筛选 - 自动向相关帖子发送个性化消息 - 跟踪已发送的消息以避免重复 - 通过launchd每小时运行一次

1. InvestBot -内幕交易分析

- 监控美国证券交易委员会表格4、国会股票法案、13F/13D/13G文件 - 计算多个内部人类型买入时的收敛分数 - 电子邮件提醒热门人选 - 回溯测试框架（11个周期内100%的阿尔法阳性） - Node.js/TypeScript

工具(/tools)

1. 图书处理机

- 监控谷歌任务“阅读”列表 - 从Library Genesis下载书籍（v3下载器） - 生成2人播客摘要 - 使用Kokoro TTS转换为有声读物 - 将所有内容上传到有序文件夹中的Google Drive - 完整的状态管理和恢复功能

配置(/configs)

1. 特工甲板 (/configs/agent-deck)

- 默认配置文件和设置 - MCP配置 - 全局搜索设置

1. 开爪 (/configs/openclaw)

- 代理工作区配置 - 模型设置（Ollama DeepSeek-R1） - 网关和身份验证设置

1. 克劳德桌面 (/configs/claude-desktop)

- MCP服务器配置 - N8N MCP集成

安装脚本(/scripts)

• setup_macos.sh -完整的macOS设置
• install_dependencies.sh -安装Homebrew、Python、Node等。
• setup_bots.sh -将所有机器人安装为launchd服务
• setup_configs.sh -部署所有配置

快速开始

# Clone the repository
git clone https://github.com/YOUR_USERNAME/jason-ai-toolkit.git
cd jason-ai-toolkit

# Run the complete setup (macOS)
./scripts/setup_macos.sh

# Or install components individually
./scripts/install_dependencies.sh  # Install prerequisites
./scripts/setup_bots.sh           # Install all bots
./scripts/setup_configs.sh        # Deploy configurations

先决条件

所需软件

• macOS （为macOS设计的脚本，可以适用于Linux）
• 家酿 -包管理器
• Python 3.10+ -基于Python的工具
• Node.js 18+ -基于JavaScript的工具
• Git -版本控制

可选但推荐

• 卡利伯 -用于EPUB到PDF的转换（图书处理器）
• 奥拉玛 -获得当地法学硕士支持（OpenClaw）
• n8n -用于工作流自动化（如果使用n8n MCP）

API密钥和证书

您需要设置：

• 谷歌OAuth -用于任务、日历、驱动器访问
• 无烟煤API密钥 -供克劳德访问
• 发送邮件 -用于通知（可选）

安装

1.安装先决条件

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python, Node, Git
brew install python@3.11 node git

# Install Calibre (for book processing)
brew install --cask calibre

# Install Ollama (for local LLMs)
brew install ollama

2.克隆和设置

git clone https://github.com/YOUR_USERNAME/jason-ai-toolkit.git
cd jason-ai-toolkit

# Run the master setup script
chmod +x scripts/*.sh
./scripts/setup_macos.sh

3.配置凭据

每个机器人都需要自己的凭据。请参阅个人机器人文档：

• 图书处理机：为Google API运行OAuth设置
• MattBot：配置谷歌日历OAuth
• 到处乱跑：不需要凭据（使用克劳德代码）
• InvestBot：为电子邮件警报配置SMTP

4.启动服务

# Load all launchd services
launchctl load ~/Library/LaunchAgents/com.jasonlee.book-processor.plist
launchctl load ~/Library/LaunchAgents/com.jasonlee.supost-bot.plist

# Or use the helper script
./scripts/start_all_services.sh

项目文件

机器人

• MattBot文档
• SUPost机器人文档
• InvestBot文档

工具

• 图书处理器文档
• LibGen下载器v3指南

配置指南

• Agent Deck设置
• OpenClaw配置
• 克劳德桌面MCP

配置

环境变量

创建一个 .env 根目录中的文件：

# Anthropic
ANTHROPIC_API_KEY=your_api_key_here

# Google OAuth (for bots that need it)
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret

# Email (for investBot alerts)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your_email@gmail.com
SMTP_PASS=your_app_password

# N8N (if using)
N8N_API_URL=http://localhost:5678
N8N_API_KEY=your_n8n_api_key

# Optional
OPENAI_API_KEY=your_openai_key

定制

每个工具都可以通过其配置文件进行自定义：

• 图书处理机：编辑 tools/book-processor/config.py
• MattBot：编辑 bots/mattbot/config.py
• InvestBot：编辑 bots/investBot/.env

故障排除

常见问题

Python venv问题

# Recreate virtual environment
cd tools/book-processor
rm -rf venv
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

已启动的D服务未启动

# Check service status
launchctl list | grep jasonlee

# View logs
tail -f ~/Library/LaunchAgents/*.log

# Reload service
launchctl unload ~/Library/LaunchAgents/com.jasonlee.SERVICENAME.plist
launchctl load ~/Library/LaunchAgents/com.jasonlee.SERVICENAME.plist

OAuth身份验证失败

# Re-run OAuth setup
cd tools/book-processor
./venv/bin/python complete_oauth.py

端口冲突

# Check what's using a port
lsof -i :5055
lsof -i :5678

# Kill process if needed
kill -9 

获取帮助

1. 检查单个项目的README文件
2. 查看每个项目的日志 /logs 目录
3. 检查launchd日志： ~/Library/LaunchAgents/*.log

建筑

jason-ai-toolkit/
├── agents/              # Agent Deck agent profiles
├── bots/               # Automation bots
│   ├── mattbot/        # Matt Knight event tracker
│   ├── supost-bot/     # Stanford housing bot
│   └── investBot/      # Insider trading analyzer
├── tools/              # Standalone CLI tools
│   └── book-processor/ # Book download/process/upload
├── configs/            # Configuration templates
│   ├── agent-deck/     # Agent Deck config
│   ├── openclaw/       # OpenClaw config
│   └── claude-desktop/ # Claude Desktop MCP
├── scripts/            # Setup and utility scripts
├── docker/             # Docker configurations (optional)
└── docs/               # Additional documentation

技术栈

• Python 3.11+：书籍处理器、MattBot、SUPost Bot
• Node.js/TypeScript：InvestBot
• SQLite：状态管理（图书处理器）
• 谷歌API：任务、日历、驱动器集成
• 安thropic克劳德：通过API进行人工智能处理
• macOS已启动：服务调度和管理

安全说明

• 永不承诺 .env 文件或凭据
• 使用 .env.example 改为模板
• OAuth令牌存储在本地，忽略git
• 敏感配置 .example 后缀

贡献

这是一个个人工具包，但请随时：

1. 叉子自用
2. 提交错误修复
3. 提出改进建议

许可证

MIT许可证-请参阅许可证文件

作者

杰森·李

• 个人AI/自动化工具包
• 用克劳德密码和拟人克劳德建造

版本历史记录

• v1.0.0 （2026-02-10）：首次发布

- MattBot、SUPost Bot、InvestBot、图书处理器 - Agent Deck、OpenClaw、Claude Desktop配置 - macOS设置脚本