Skip to content
0xthearchitectPublic

Repository files navigation

Pocketme — your own private workspace, running on your own hardware

Chat, files and a growing library of self-hosted apps — Git, media, a password vault, an AI chat UI, even a game server — all reachable from one small widget that lives in your tray. No subscriptions, no accounts on someone else's server, no one else's eyes on your data.

MIT licensed Windows macOS Linux

Realtime chat in Pocketme The Services app store

Why Pocketme

  • It's yours. Everything runs on a machine you control — a laptop, a home server, a spare mini PC. Your messages and files never leave your network unless you choose to expose them.
  • A real desktop app, not a browser tab pretending to be one — a compact, frameless widget that docks out of the way in your system tray, built with Tauri so it stays light.
  • Realtime chat — channels, mentions, replies, edits — for you and anyone else on your network.
  • A files hub — upload, organise, share by link or by person, with a Trash that actually restores things.
  • An app store for your own server. Install Git hosting (Forgejo), a media server (Jellyfin), a password manager (Vaultwarden), a local AI chat UI (Open WebUI), automations (n8n), even a Terraria server — each one arrives as a real container and opens straight from Pocketme, no manual Docker wrangling.
  • Found by name on your network, not by hunting for an IP address, on Windows, macOS, Linux, iOS and Android alike.
  • Free and open source. The core you're looking at costs nothing and always will — see Editions below.

Quick start

git clone https://github.com/0xthearchitect/Pocketme.git
cd Pocketme
npm install
npm run build:desktop   # builds the desktop app (web → sidecar → installer)

That produces an installer under apps/desktop/src-tauri/target/release/bundle/. Prefer to just poke at the API first? npm run dev starts the server alone at http://127.0.0.1:8080.

Windows needs a couple of extra one-time tools (Rust, Bun) before that build step — see the full Installation guide, which also covers connecting to your server from another device on the network.

Editions & licence

Pocketme follows an open-core model across two repositories:

  • This repo is Pocketme — everything you see here, open-source and free forever under the MIT licence.
  • Pocketwork, a separate paid edition, adds a small-business suite (products, stock, sales, invoicing) as a private overlay on top of this same core — see ADR-0002 if you're curious how that split works.

Documentation

The docs/ folder has the full specification: architecture, API, security model, and the reasoning behind the bigger decisions (docs/adr/).

Contributing

Issues and pull requests are welcome. The test suite (npm test) covers the server, and runs in CI on every pull request.

License

MIT

Releases

Packages

Contributors

Languages