项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1302
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 运行环境(因为安装方式为 npm install)
- npm 包管理器
- 一个已有的 Node.js/TypeScript 项目目录
- 可选的 LLM 服务凭证(示例使用 OpenAI 的 gpt-4o 模型)
安装与启动步骤
-
1准备项目目录
在本地新建或进入你已有的 Node/TypeScript 项目目录,SDK 会安装到该项目中。
mkdir my-agent && cd my-agent -
2初始化 npm 项目
若目录还没有 package.json,先初始化,否则 npm install 无法记录依赖。
npm init -y -
3安装 SmythOS SDK
README 的“Method 2: Direct SDK Installation”给出的唯一安装命令,把 SDK 加入现有项目。
npm install @smythos/sdk -
4编写使用代码
参考 examples 目录与 SDK 文档,用 Agent.import 载入 .smyth 文件并调用 prompt;也可用 stream()/chat() 模式。
-
5运行并调试
按你项目的运行方式执行代码;若 CLI 或代码报错,设置 LOG_LEVEL="debug" 后重跑并把日志发给社区。
LOG_LEVEL="debug"
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
LOG_LEVEL | 否 | 排查 CLI 或代码问题时的日志级别,设为 debug 输出详细日志 | debug |
model | 否 | Agent.import 时指定的模型,示例为 OpenAI 的 gpt-4o | Model.OpenAI('gpt-4o') |
如何确认成功
运行代码后 agent.prompt 正常返回并打印结果,无报错即表示 SDK 安装与调用成功。
常见问题
Q:安装或运行代码时报错怎么办?
A:按 README 提示设置环境变量 LOG_LEVEL="debug",重新运行代码,然后把日志分享给官方社区,便于定位问题。
Q:只想拖拽搭建智能体,不想写代码怎么办?
A:可使用同团队开源的 SmythOS Visual Agent Studio(github.com/SmythOS/smythos-studio),提供可视化拖拽界面。
Q:支持哪些模型、存储和向量库?
A:LLM 支持 OpenAI、Anthropic、Google AI、AWS Bedrock、Groq、Perplexity;存储支持本地、S3、GCP、Azure;向量库支持 Pinecone、Milvus、RAMVec;缓存支持 RAM、Redis。
Q:在哪里找可运行的示例代码?
A:仓库的 examples 目录提供代码示例,官方还提供 sre-project-templates 代码模板库和 SDK 在线文档。
注意事项
- README 未提供 Docker、git clone 或 CLI 的完整安装命令,本教程仅覆盖官方明确给出的 npm install @smythos/sdk 方式。
- README 未给出运行示例代码的具体命令,请按你现有项目的运行方式执行(如项目自身的脚本)。
- 仓库包含 SRE 内核(packages/core)、SDK 与 CLI 三部分,内核具备模块化连接器、Candidate/ACL 安全机制、资源管理与智能体生命周期编排能力。
- 进一步资料见 SDK 文档、SRE Core 文档与 CONTRIBUTING.md。
核心亮点
- 基于TypeScript,类型安全,易于扩展和维护
- 云原生设计,支持本地、云端和边缘多环境部署
- 内置安全沙箱和权限控制,适合企业级生产使用
不足之处
- 项目较新,社区规模和文档成熟度待观察
- 依赖特定运行时,迁移成本可能较高
适用场景
- 企业级AI智能体的生产环境部署与运维
- 边缘设备上运行轻量级AI代理
- 多环境(本地/云/边缘)统一的AI开发测试流程
替代项目
LangChain、AutoGPT、Ray
同类项目推荐
mono-color-skill
开源
让 AI 一键生成高级单色印刷海报,告别廉价感。
One-ink editorial print image skill — warm paper, halftone photography, active nega···
clinicaltrialsgov-mcp-server
开源
让 AI 智能体一键检索全球临床试验,自动匹配患者入组。
Search ClinicalTrials.gov trials, retrieve study details and results, and match pati···
parlant
开源
让 AI 代理按规矩办事,客户交互更可靠
Parlant is an open platform for building customer-facing chat agents with AI. Descri···
opencode-mcp
开源
让任意 MCP 客户端直接调用 OpenCode 的 70 个 AI 工具
MCP server for OpenCode AI — 70 tools, 10 resources, 5 prompts. Use npx opencode-mc···
DataMind
开源
说句话就能完成数据分析,自动生成图表和报告
[ICLR/AAAI/KDD/EMNLP2026] Open-Source LLM-Based Data Analysis Agents
agentmemory
开源
给编码智能体装上跨会话记忆,不用每次重讲项目背景
#1 Persistent memory for AI coding agents based on real-world benchmarks
bkit-claude-code
开源
用 PDCA 流程管好 AI 编程,让 Claude Code 输出更稳
bkit Vibecoding Kit - PDCA methodology + Claude Code mastery for AI-native developme···
ai-hedge-fund-crypto
开源
用AI智能体帮你像对冲基金一样炒币,自动分析并给出买卖信号。
AI-Hedge-Fund for Crypto AI-powered hedge fund for cryptocurrency trading, leverag···
deepcontext-mcp
开源
给 AI 编程助手装上代码符号雷达,大型代码库秒级定位上下文
DeepContext is an MCP server that adds symbol-aware semantic search to Claude Code, ···
