Repolode
xiaomoBoy

xiaomoBoy/pi-durable-assistant

Self-hosted personal AI agent built on Pi Durable that resumes tasks after process restarts, with subagents, scheduled jobs, a browser UI and an optional WeChat bridge.

Stars
38
Forks
4
Open issues
0
Last commit
9 days ago

What is it?

Pi Durable Assistant is a self-hosted personal AI agent that keeps running work alive across process crashes. Tasks, conversations and document state are persisted to SQLite, so unfinished work can be recovered after a restart and its result viewed later in the browser.

The project runs as a Node.js 22 server with a plain JavaScript web UI using server-sent events, and it can be started locally with a built-in faux model for trying out the interface without an API key. For real use, it connects to OpenAI-compatible or Anthropic-style model APIs. It also offers foreground and background subagents, one-time or interval-based scheduled tasks, persistent notes, image and text attachments, optional webhook or Feishu notifications, and a WeChat iLink channel through a separate container.

Deployment is provided through Docker Compose, binding to localhost by default with HTTP Basic Auth. The project is described as an experimental single-user implementation rather than an official Pi Durable product.

Key features

  • 01Resumes recoverable tasks after the process restarts, backed by SQLite persistence
  • 02Browser chat UI with multiple sessions, forking and token usage display
  • 03Foreground and background subagents that can be viewed, stopped and resumed
  • 04One-time or fixed-interval scheduled tasks that can be paused, resumed or cancelled
  • 05Read-only search over whitelisted Obsidian notes with source paths and line numbers
  • 06Optional WeChat iLink channel handling text and voice transcripts

Use cases

  • Running long-lived research or background tasks that should survive a server restart
  • Hosting a private personal assistant on a VPS with Docker Compose
  • Setting up recurring reminders that push notifications to a webhook or Feishu bot
  • Chatting with a self-hosted agent from a WeChat account

Topics

FAQ

What is pi-durable-assistant?
Self-hosted personal AI agent built on Pi Durable that resumes tasks after process restarts, with subagents, scheduled jobs, a browser UI and an optional WeChat bridge. Pi Durable Assistant is a self-hosted personal AI agent that keeps running work alive across process crashes. Tasks, conversations and document state are persisted to SQLite, so unfinished work can be recovered after a restart and its result viewed later in the browser.
Is pi-durable-assistant free to use? What license does it have?
pi-durable-assistant is open source under the MIT license. Check the license terms before using it in commercial products.
Is pi-durable-assistant still maintained?
Actively maintained. The last commit to pi-durable-assistant was on Oct 11, 2026.
What can I use pi-durable-assistant for?
Running long-lived research or background tasks that should survive a server restart Hosting a private personal assistant on a VPS with Docker Compose Setting up recurring reminders that push notifications to a webhook or Feishu bot Chatting with a self-hosted agent from a WeChat account
Where can I get pi-durable-assistant?
The source code and installation instructions are on GitHub: https://github.com/xiaomoBoy/pi-durable-assistant

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects