selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Pi Pocket logo

Self-host Pi Pocket

v0.26.0

Mobile-first web app for Pi coding agent with durable runs

BetaOpen SourceMIT
Updated9 hours ago
LanguageTypescript
Setup difficultyModerate
MobilePWA
ThemeDark mode
Stars
707
Port
8787 (HTTP server for web UI and API)
Requires
Chromium, Pi coding agent
Install with Android
Session list on Android phone showing working, waiting, and done sessionsSession view on iPhone with Pi fixing a sign-in redirect loop and Lancet Guard waiting for git push approvalPeople sheet on iPhone showing multiplayer chat with mentions and repliesPiP assistant open over a session on Android phone starting a regression test in a worktreeWide screen desktop view with session list, conversation timeline with diffs, and peek tiles of other sessions

What is Pi Pocket?

This project provides a web interface for the Pi coding agent that you host yourself. It works on phones and desktop browsers, lets multiple people join the same session with live updates, and stores every step in a local SQLite database so work continues after a restart. You can run it with Docker Compose, Nix, plain npm, or on Android via Termux. It includes a built-in Chromium browser for Pi to use, a system of drop-in extensions, themes from the Omarchy collection, and an assistant called PiP that can start and monitor other sessions. Access can be limited to your machine, your LAN, a Cloudflare tunnel, or a Tailscale network. Requires Node.js 22.19 or newer. Licensed under MIT.

Should you self-host Pi Pocket?

Pi Pocket scores 50/100 on selfhost.directory (how scoring works) and ranks #40 of 120 in AI Assistant. It has 707 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v0.26.0, came out on 27 October 2026. New versions land roughly every 1 days.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is hermes-agent (89/100, 257 885 stars). It scores higher overall, so compare the two before you pick. See Pi Pocket vs hermes-agent side by side.

Features

  • Artifacts
  • Built-in browser
  • Durable runs
  • Extensions
  • Forks and worktrees
  • Lancet Guard
  • Memory
  • Model selection per session
  • Multiplayer sessions
  • PiP assistant
  • Plan mode
  • Scheduled messages
  • Subagents

Pi Pocket README

How to install Pi Pocket

Install Pi Pocket with Android

Termux with Node.js and git
Environment variables
PI_POCKET_GUARD

pkg update && pkg upgrade && pkg install nodejs git npm install -g --ignore-scripts @earendil-works/pi-coding-agent pi # /login, then quit git clone https://github.com/TannerMidd/pi-pocket.git cd pi-pocket && npm install --ignore-scripts && termux-wake-lock && npm start

Lancet Guard may not load; use PI_POCKET_GUARD=off if it fails.

How to configure Pi Pocket

  • PI_POCKET_ACCESSlanAccess mode: lan, cloudflare, tailscale, or local

    Access mode: lan, cloudflare, tailscale, or local

    values: lan | cloudflare | tailscale | local

  • PI_POCKET_BIND0.0.0.0Host address the port is published on

    Host address the port is published on

  • PI_POCKET_BROWSER/usr/bin/chromiumPath to Chromium/Chrome binary for built-in browser

    Path to Chromium/Chrome binary for built-in browser

  • PI_POCKET_BROWSER_ARGS--no-sandbox --disable-dev-shm-usageChromium flags inside the container

    Chromium flags inside the container

  • PI_POCKET_DATA./dataHost folder for database, config, uploads, worktrees, browser profile, logging

    Host folder for database, config, uploads, worktrees, browser profile, logging

  • PI_POCKET_EXTENSIONS./data/extensionsHost folder for drop-in extensions

    Host folder for drop-in extensions

  • PI_POCKET_GUARDSet to 'off' to disable Lancet Guard

    Set to 'off' to disable Lancet Guard

    values: off

  • PI_POCKET_PI_DIR./data/piHost folder for Pi's auth.json, settings, skills, prompts, sessions

    Host folder for Pi's auth.json, settings, skills, prompts, sessions

  • PI_POCKET_PORT8787Port on both host and container

    Port on both host and container

  • PI_POCKET_THEMES./data/themesHost folder for custom themes

    Host folder for custom themes

  • PI_POCKET_WORKSPACE./data/workspaceHost folder for projects Pi works on

    Host folder for projects Pi works on

Pi Pocket releases & version history

More in Collaboration

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…