Repolode
提交项目
disler

disler/durable-pi

运行在你自有设备上的持久化 Pi 智能体，客户端断开或设备重启后可从检查点继续，支持网页、终端和 curl 访问。

在 GitHub 查看官网
Star
343
Fork
94
未关闭 Issue
0
最近提交
27天前

这是什么？

Durable Pi 是基于 pi-durable 构建的持久化智能体网络。每台设备运行一个小型服务 dpi-backend，负责管理本机的智能体、它们的 SQLite 数据库和工具。客户端通过 URL 和 Bearer Token 连接，可以使用汇总所有设备的网页中枢、终端客户端 dpi-tui，或一条 curl 命令。

智能体在输出结果之前，会先把对话历史、排队中的输入、任务检查点和应用状态写入 SQLite。关闭浏览器、退出终端或在工具运行途中重启机器后，任务都会从最近的检查点继续。可能已部分执行的工具会以“中断”结果返回，而不会被静默重复执行。

仓库中还包含一个主动式演示：智能体由日志事件自动启动，提前准备修复方案，等待人工审批后部署。项目支持上下文压缩、会话分叉、共享的 JSON 应用状态、持久化任务，以及按智能体切换工具权限。设备通过 YAML 文件声明，可借助 SSH、systemd、launchd 或 exe.dev 完成部署。

核心功能

  • 01智能体在输出前将历史、排队输入和检查点写入 SQLite。
  • 02客户端断开或设备重启后，任务从最近检查点恢复。
  • 03网页界面、终端客户端 dpi-tui 和 HTTP API 共用同一套智能体后端。
  • 04可在任意条目处分叉智能体，子智能体嵌套在父级之下。
  • 05共享 JSON 应用状态，支持原子路径更新并检测 409 冲突。
  • 06设备通过 YAML 声明，可经 SSH、systemd、launchd 或 exe.dev 部署。

适用场景

  • 在家用服务器或云主机上运行个人编码智能体，随时从任意设备接入。
  • 构建由日志事件触发的主动式智能体，在你查看之前完成前期工作。
  • 在故障处理期间，让多名工程师同时观察和操控同一个智能体。
  • 将可持久化、支持多客户端的智能体嵌入自有产品的界面。

快速上手

  1. 1

    复制环境变量模板并设置 OPENROUTER_API_KEY

    cp .env.example .env
  2. 2

    复制网络配置模板

    cp dpi-network.example.yaml dpi-network.yaml
  3. 3

    安装所有包的依赖

    just install
  4. 4

    注册本机、构建网页界面并启动后端

    just net up local

使用前须知

  • 运行需要 Node.js 24、just、zsh 和 OpenRouter API 密钥。
  • 远程设备需要免密 ssh，并且每台机器都需要额外设置。

收录于专题

开源 AI Agent 框架与应用命令行与终端工具数据库与 SQL 工具

标签

#ai-agents#agentic-engineering#sqlite#typescript#durable-execution#llm#cli#durable-agents#pi

常见问题

durable-pi 是什么？
运行在你自有设备上的持久化 Pi 智能体，客户端断开或设备重启后可从检查点继续，支持网页、终端和 curl 访问。 Durable Pi 是基于 pi-durable 构建的持久化智能体网络。每台设备运行一个小型服务 dpi-backend，负责管理本机的智能体、它们的 SQLite 数据库和工具。客户端通过 URL 和 Bearer Token 连接，可以使用汇总所有设备的网页中枢、终端客户端 dpi-tui，或一条 curl 命令。
durable-pi 可以免费使用吗？用的什么许可证？
durable-pi 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
durable-pi 还在维护吗？
活跃维护中。durable-pi 最近一次提交是在 2026年10月11日。
durable-pi 适合用来做什么？
在家用服务器或云主机上运行个人编码智能体，随时从任意设备接入。 构建由日志事件触发的主动式智能体，在你查看之前完成前期工作。 在故障处理期间，让多名工程师同时观察和操控同一个智能体。 将可持久化、支持多客户端的智能体嵌入自有产品的界面。
durable-pi 怎么安装和运行？
复制环境变量模板并设置 OPENROUTER_API_KEY: cp .env.example .env 复制网络配置模板: cp dpi-network.example.yaml dpi-network.yaml 安装所有包的依赖: just install 注册本机、构建网页界面并启动后端: just net up local
在哪里获取 durable-pi？
源代码和安装说明在 GitHub 上：https://github.com/disler/durable-pi

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目