Pistisai — ΠΙΣΤΙΣΑΙ
A local-first companion and desktop capability layer for your AI agent. Private, secure, yours.
Πίστις (Pistis) — the ancient spirit of trust, honesty, and good faith. After fleeing Pandora's box, she returned to Olympus. Pistisai builds a Stoa worthy of her return.
Your AI runs on your hardware. The app gives it voice, vision, desktop control, and a secure channel across all your devices — no data leaves your network unless you decide otherwise.
Try It Now
🌐 pistisai.app — Web app, works in any browser. One-liner:
open https://pistisai.app && log in. No build step. That's the fastest way to try Pistisai.
🐧 Linux — curl -fsSL https://pistisai.app/install.sh | bash (AppImage + auto-update daemon; rolling out).
📱 Android — APK builds from CI. Grab the latest from Releases.
You need an agent runtime. Hermes is the primary test path. OpenClaw and compatible agent gateways also work.
🚀 Public launch is live. Full quick-start, supported runtimes, and self-hosting steps → docs/LAUNCH.md. Primary CTA: clone the repo, run a workflow, and open an issue or discussion with your real use case. Track the launch → GitHub issue #39.
🏛️ Why we exist → docs/governance/manifesto.md — the meaning of Πίστις and the Four Pillars behind the product.
What Sets It Apart
| Layer | What it gives you |
|---|
| Secure Channel | Direct line to your agent, synced across devices |
| Voice + Avatar | Sidecar companion with personality, memory, natural conversation |
| Desktop Control | Permissioned access to apps, windows, keyboard, files |
| Vision | Screen awareness, OCR, camera — explicit per-action consent |
| Device Mesh | Tailscale-first private network across all your machines |
| Runtime Manager | Manage agents, skills, sessions, tools, diagnostics |
Architecture
┌────────────────────────────────────────────────────────┐
│ Pistisai App │
│ ┌──────────┐ ┌──────────┐ ┌────────────────────┐ │
│ │ Agent │ │ Avatar │ │ Desktop Control │ │
│ │ Channel │ │ Voice │ │ Vision │ │
│ └────┬─────┘ └────┬─────┘ └───────┬────────────┘ │
│ └──────────────┼────────────────┘ │
│ ▼ │
│ ┌──────────────────────┐ │
│ │ Agent Adapter │ │
│ │ Hermes / OpenClaw │ │
│ └──────────┬──────────┘ │
└──────────────────────┼───────────────────────────────────┘
│
┌────────┴────────┐
│ │
┌────▼────┐ ┌─────▼──────┐
│ Local │ │ Model │
│ Agent │ │ Providers │
│ Runtime│ │ (Ollama, │
│ │ │ LM Studio)│
└─────────┘ └────────────┘
Technical deep-dive → System Architecture
Platforms
| Platform | Status |
|---|
| 🐧 Linux | ✅ AppImage + auto-update daemon |
| 🌐 Web | pistisai.app |
| 📱 Android | ✅ APK builds from CI |
| 🪟 Windows | ✅ Installer (InnoSetup) + CI |
| 🍎 macOS | ✅ Installer + CI |
Development
git clone https://github.com/pistisAI/pistisai-app.git
cd pistisai-app
flutter pub get
# The app depends on a separate shared package — get its deps too:
cd lib/shared && flutter pub get && cd ../..
# Run
flutter run -d linux # Desktop
flutter run -d chrome # Web
# Build
flutter build linux --release
flutter build web --release --no-web-resources-cdn
flutter build apk --release --split-per-abi
flutter build windows --release
flutter build macos --release
Backend Services
cd services/api-backend && npm install && npm run dev
cd services/streaming-proxy && npm install && npm run dev
Developer onboarding → docs/development/DEVELOPER_ONBOARDING.md.
Command reference → AGENTS.md.
Documentation
📖 docs.pistisai.app
License
MIT — see LICENSE.
