Cartrita AI试剂
使用Node.js、TypeScript和现代AI API构建的复杂多代理AI系统
最新堆栈（Node.js 22+| TypeScript | Biome | 2025 API）
该系统实现了一个全面的AI代理编排平台，该平台由以下部分构建：
- Node.js 22+ 使用TypeScript和现代ES模块
- 生物群系 用于闪电般快速的linting/格式化（比ESLint快15倍）
- 多代理架构 与专门的代理人一起完成不同的任务
- TypeScript 具有严格的型号安全性
- PostgreSQL 17+pgvector 用于向量相似性搜索
- 禁食 高性能web框架
🚀 快速开始
5分钟后起床跑步：
# 1. Clone and install
git clone https://github.com/Punky2280/cartrita-mcdaniels.git
cd cartrita-mcdaniels
pnpm install
# 2. Setup environment
cp .env.example .env
# Edit .env with your API keys (see Configuration below)
# 3. Start database
pnpm run docker:up
# 4. Run migrations
pnpm run db:migrate
# 5. Start development server
pnpm run dev📋 先决条件
- Node.js 22+ （推荐LTS）
- pnpm （包管理器）
- 码头工人 （适用于PostgreSQL数据库）
- API密钥 （OpenAI，可选：Anthropic、Tavily等）
🏗️ 建筑
该系统使用 多代理编排模式 与专业代理商合作：
- 研究代理：网络搜索和信息收集
- 代码代理：代码生成和分析
- 知识代理：文档检索和RAG
- 任务代理：项目规划和管理
每个代理都扩展了一个公共 BaseAgent 通过中央协调器进行接口和通信。
⚙️ 配置
中所需的环境变量 .env:
# Database (PostgreSQL with pgvector)
DATABASE_URL="postgresql://postgres:postgres123@localhost:5432/cartrita_ai_agents"
# Core AI API (required)
OPENAI_API_KEY=sk-proj-...
# Optional AI APIs
ANTHROPIC_API_KEY=sk-ant-api03-...
# External Services (optional)
TAVILY_API_KEY=tvly-... # Web search
DEEPGRAM_API_KEY=... # Speech services
GITHUB_TOKEN=ghp_... # GitHub integration
# Server
NODE_ENV=development
PORT=3000
LOG_LEVEL=info�️ 发展
# Start development server with hot reload
pnpm run dev
# Run tests
pnpm test
# Build for production
pnpm run build
# Check code quality
pnpm run check
# Database operations
pnpm run db:migrate # Run migrations
pnpm run db:studio # Open Drizzle Studio🤖 克劳德终端集成
该项目包括全面的Claude AI终端集成，独立于VS Code扩展：
# Quick Claude access
pnpm claude # Interactive Claude session
pnpm claude -p "Analyze this TypeScript code" # Single query mode
# Code analysis and review
pnpm claude:analyze src/main.ts # Analyze specific file
pnpm claude:review --diff # Review git changes
pnpm claude:docs src/agents/BaseAgent.ts # Generate documentation
# Advanced usage
./scripts/claude-launch.sh --model opus "Complex architectural question"
./scripts/claude-review.sh --staged # Review staged changes特征：
- 仅限终端操作：无VS代码扩展依赖关系
- 项目上下文：自动项目理解和TypeScript意识
- 安全的API密钥管理：基于环境的配置
- 多种型号：选择克劳德·十四行诗、歌剧和俳句
- 可脚本化界面：非常适合自动化和CI/CD集成
快速设置：
- 安装Claude CLI：
npm install -g @anthropic-ai/claude-code - 将API密钥添加到
.env:ANTHROPIC_API_KEY=sk-ant-api03-... - 开始使用：
pnpm claude
有关完整的设置说明，请参阅： instructions/claude-terminal-setup.md
📚 文档
🚢 部署
# Using Docker Compose
docker compose up -d
# Manual production build
pnpm run build
NODE_ENV=production pnpm start🧪 技术栈
| 组件 | 技术 | 目的 |
|---|---|---|
| 运行时 | Node.js 22+ | JavaScript运行时 |
| 语言 | TypeScript | 类型安全 |
| 框架 | Fastify | 高性能web服务器 |
| 数据库 | PostgreSQL+pgvector | 带向量搜索的数据存储 |
| 人工智能集成 | OpenAI，人类智能 | 代理智能 |
| 代码质量 | 生物特征 | 绒毛和格式化 |
🔧 故障排除
常见问题
“无法连接到数据库”
# Ensure PostgreSQL is running
pnpm run docker:up“缺少API密钥错误”
# Check your .env file has required keys
cat .env | grep OPENAI_API_KEY“端口3000已在使用中”
# Change port in .env
echo "PORT=3001" >> .env🤝 贡献
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
此项目根据ISC许可证获得许可-请参阅 许可证 文件以获取详细信息。
🆘 支持
- 文档：检查 docs/ 文件夹
- 问题：打开a
- 讨论：加入我们
______________________________________________________________________
*内置于❤️ 使用TypeScript和现代AI API*
🔧 技术栈
| 组件 | 技术 | 版本 | 目的 |
|---|---|---|---|
| 运行时 | Node.js | 22+ | 具有最新功能的现代js运行时 |
| 语言 | TypeScript | 5.6+ | 类型安全和开发人员体验 |
| 剥皮 | 生物特征 | 1.9+ | 超快剥皮（比ESLint快15倍） |
| 后端 | 快速 | 5+ | 高性能HTTP服务器 |
| 前端 | React+Vite | 最新 | 快速构建的现代前端 |
| 数据库 | PostgreSQL+pgvector | 17+0.8+ | 用于嵌入的向量数据库 |
| AI代理 | OpenAI代理SDK | 最新 | 官方多代理框架 |
| AI模型 | OpenAI、Anthropic、HF | 2025 API | 最新AI模型集成 |
🤖 支持的AI服务
- OpenAI：GPT-4、嵌入、助理、代理
- Anthropic：Claude 3.7，工具助手，流媒体
- 拥抱的脸：Transformers.js、模型、数据集
- Deepgram：语音转文本、文本转语音、语音代理
- GitHub：用于代码集成的Octokit SDK
- 网页搜索：Tavily，SerpAPI用于实时数据
🐳 Docker支持
统一容器设置，包括：
- PostgreSQL 17+pgvector扩展
- Redis用于缓存
- 后端和前端服务
- 健康检查和自动重启
📖 后续步骤
- 阅读 工程剧本 用于全面设置
- 探索代理示例
packages/ai-agents/ - 查看API文档，网址：
http://localhost:3000/docs - 使用Biome+TypeScript加入我们的开发工作流程
______________________________________________________________________
*内置于💚 使用最新的2025 AI和Node.js技术*