▄████  ██░ ██  ▒█████    ██████ ▄▄▄█████▓
                           ██▒ ▀█▒▓██░ ██▒▒██▒  ██▒▒██    ▒ ▓  ██▒ ▓▒
                           ▒██░▄▄▄░▒██▀▀██░▒██░  ██▒░ ▓██▄   ▒ ▓██░ ▒░
                           ░▓█  ██▓░▓█ ░██ ▒██   ██░  ▒   ██▒░ ▓██▓ ░ 
                           ░▒▓███▀▒░▓█▒░██▓░ ████▓▒░▒██████▒▒  ▒██▒ ░ 
                           ░▒   ▒  ▒ ░░▒░▒░ ▒░▒░▒░ ▒ ▒▓▒ ▒ ░  ▒ ░░   
                              ░   ░  ▒ ░▒░ ░  ░ ▒ ▒░ ░ ░▒  ░ ░    ░    
                           ░ ░   ░  ░  ░░ ░░ ░ ░ ▒  ░  ░  ░    ░      
                                 ░  ░  ░  ░    ░ ░        ░            

your data. your keys. your ghost.

what is this?

ghost is a zero-knowledge encrypted personal assistant that actually respects your privacy. think obsidian meets signal meets ai

built for future sovereign individuals

current status: ios app in active dev → web/mac desktop coming soon™

features that actually matter

• 🔐 zero-knowledge encryption - we literally can't read your shit even if we wanted to
• 🏝️ offline-first - works without internet, syncs when you want it to (except the AI model, no model currently possible to power Ghost offline yet)
• 🤖 ai that's actually private - your conversations only leave your device to a cloudflare worker running open-sourced LLMs meant to only process your query
• 🔑 you own your keys - lost your passphrase? we can't help you. gg.
• 📱 ios-first - on the go support

tech stack (for the nerds)

├── expo (for easy ios builds)
├── react native (for building ios/web apps)
├── supabase (auth + postgres)
├── powersync (offline-first sqlite sync to connect iphone/web/mac)
├── op-sqlite (sqlcipher encryption)
├── react-native-quick-crypto (actual crypto, not "crypto")

quick start

prerequisites

you need to know what you're doing with:

• expo
• react native
• basic understanding of encryption

setup

# clone this bad boy
git clone https://github.com/your-username/ghost.git
cd ghost

# install deps
pnpm install

# setup your env
cp apps/mobile/.env.example apps/mobile/.env
# add your supabase and powersync urls/keys

# run the dev build on your device
cd apps/mobile
npx expo run:ios

# or if you already have a dev build installed
npx expo start

important notes

• this requires an expo development build - expo go won't work because we use native modules
• ios only for now - then web/macOS
• you need your own supabase instance - to sync iphone/mac/web
• powersync requires setup - check infra/powersync/sync-rules.yaml

architecture

ghost/
├── apps/
│   └── mobile/          # ios app (expo)
├── packages/
│   └── core/           # shared crypto & types
└── infra/              # supabase + powersync config

security model

1. client-side encryption everything - selective field encryption (sfe)
2. zero-knowledge by default - e2ee mode available for recovery
3. sqlcipher on device - your local db is encrypted too
4. no bullshit - no analytics, no tracking

contributing

we accept prs. help welcomed. im still learning.

roadmap

• frontend ios app foundation
• zero-knowledge vault
• offline-first sync
• ai integration (local + workers)
• calendar integration
• reminders
• web app
• mac desktop app

license

mit - i just want my name out there

---

built with 🖤 by Bootoshi

"privacy is not about having something to hide. privacy is about having something to protect."