Stello Examples

Stello 的官方示例和演示。

快速开始

git clone https://github.com/stello-agent/stello-examples.git
cd stello-examples

# 运行 demo
cd demo
pnpm install
pnpm dev              # 运行 basic.ts

# 运行交互式可视化
cd ../visualizer-test
pnpm install
pnpm export           # 需要先有 demo 生成的 stello-data
pnpm dev

所有示例依赖 @stello-ai/core 和 @stello-ai/visualizer，从 npm 安装。

示例列表

demo/ — 基础功能演示

脚本	说明	命令
basic.ts	最小启动 — 创建根 Session + afterTurn	pnpm dev
conversation.ts	多轮对话 + 记忆更新	pnpm conversation
branching.ts	Session 分支 + 记忆继承	pnpm branching
cross-reference.ts	跨分支引用	pnpm cross-reference
agent-tools.ts	8 个 Agent Tool 全部演示	pnpm agent-tools
full-flow.ts	完整生命周期 + 可视化导出	pnpm full-flow

visualizer-test/ — 交互式星空图

基于 Vite + React 的可视化测试项目。需要先运行 demo/full-flow.ts 生成 stello-data/ 数据，然后 pnpm export 导出为 public/data.json。

学习路径

建议按以下顺序：

1. basic — 理解 Session 基本概念和文件系统
2. conversation — 对话记录和记忆提取
3. branching — Session 分支和继承策略
4. cross-reference — 跨分支引用
5. agent-tools — LLM 通过 tools 操作 Session
6. full-flow — 综合运用所有功能
7. visualizer-test — 可视化交互

相关链接

• Stello 主仓库
• @stello-ai/core
• @stello-ai/visualizer

License

Apache-2.0