SpinAI

SpinAI是一个开源的AI代理框架，专为简化AI代理的开发、调试与运维而设计。它主打开箱即用的可观测性，无需额外编码即可自动记录令牌消耗、响应时长、错误信息和成本数据，并提供实时仪表盘进行监控；内置CLI工具和模板化项目结构，支持一键初始化代理项目；深度集成Model Context Protocol（MCP），轻松接入GitHub等外部平台能力；同时兼容OpenAI等主流大模型提供商，配置灵活，本地开发与云端部署双支持，适合追求高效迭代与透明调试的开发者。

• ✓ 开箱即用的全自动可观测性（日志、耗时、令牌、成本）
• ✓ 基于CLI的快速项目初始化与多模板支持
• ✓ 原生集成Model Context Protocol（MCP），可扩展外部平台操作能力
• ✓ 支持多种大模型提供商，通过环境变量灵活切换
• ✓ 内置重新运行与错误跟踪功能，便于快速调试

1. 1 运行npx create-spinai-app命令创建新项目
2. 2 在项目中配置.env文件填入LLM API密钥等参数
3. 3 执行npm run dev启动本地代理服务
4. 4 通过命令行或仪表盘与代理交互并观察实时日志
5. 5 按需安装MCP动作（如GitHub插件）并集成到代理逻辑中

• → 自动化代码托管助手（如GitHub仓库管理、Issue处理）
• → 企业级业务流程自动化（连接CRM、ERP等系统）
• → AI代理原型快速验证与教学演示
• → 面向开发者的LLM工作流实验与性能调优