Agentic loop
多轮对话、工具调用、状态转换和停止条件共同组成主循环。
WIP Agent Runtime
Ripple 涟漪
一个面向本地工具调用、Skill 工作流和 user sandbox 的 Python Agent 系统。
Ripple 把 agentic loop、工具编排、权限 Hook、上下文压缩和 FastAPI Server 收在同一个工程里，让一次提问可以稳定地扩展成可追踪、可验证的执行过程。
Python 3.13+
后端核心
FastAPI + Next.js
服务与 Web 界面
Skills + Hooks
可复用流程与执行验证
What makes Ripple different
不是一个聊天壳，而是一套 Agent 运行系统。
Skills
用 Markdown + YAML frontmatter 定义可复用任务模板和领域流程。
Hooks
在工具调用前后做验证、拦截和权限判断，让执行链路更可控。
User sandbox
以 user_id 隔离长期 workspace，同一用户的多个 session 共享上下文。
How it works
一次请求，从上下文进入，到工具结果回流。
1
Session starts
Server 根据 user_id 准备 sandbox、会话状态和可用工具。
2
Agent decides
核心 loop 读取上下文，决定回复、调用工具或继续推理。
3
Tools run
工具系统处理并发、权限、Hook 和执行结果。
4
State returns
消息、任务进度和输出回写到会话，前端持续更新。
Architecture
核心能力清晰拆在几个边界里。
core / agent_loop
tools / orchestration
skills / executor
hooks / validation
sandbox / nsjail
interfaces / server
interfaces / web
compact / context
Quickstart
本地启动只保留必要步骤。
主页只做介绍，完整配置细节仍然放在 README 和项目文档里。Ripple 当前仍处于快速开发阶段， 接口和机制可能持续调整。
uv sync
cp config/settings.yaml.sample config/settings.yaml
uv run ripple
cd src/interfaces/web
bun run dev