Odysseus Mobile — a native iOS/Android remote for your Odysseus server 🛶📱

[mahdi-salmanzade]

I built a small native mobile app that pairs to your Odysseus server over the LAN and lets you chat with your own models from your phone — local-first, nothing leaves your network. It's free, open-source, and exists only because Odysseus does. 🙏

👉 Repo: https://github.com/mahdi-salmanzade/odysseus-mobile

What it is

A thin native client (Expo SDK 56 · React Native 0.85 · React 19) — not a webview wrapper. You run Odysseus at home as usual, pair your phone over the same Wi-Fi, and get:

• 💬 Streaming chat with your own models (SSE, the same /api/chat_stream you already have)
• 🗂️ Sessions, Notes, Tasks, Memory — navigable from the phone
• 🔐 Local-first: pairing is just { host, port, token }, stored only on-device in the iOS/Android keychain (expo-secure-store). No cloud, no account, no telemetry.

How pairing works

It leans on the auth Odysseus already has — an ody_ API token on the Authorization: Bearer header. A tiny companion bridge (a few additive routes, no LLM logic duplicated) lets the phone discover the server and verify the pairing:

• GET /api/companion/ping — cheap, auth-validated health check
• GET /api/companion/info — server identity + capability flags
• GET /api/companion/models — the caller's own model endpoints (owner-scoped, never returns key material)

An admin mints a one-time pairing code (scripts/pair_mobile.py prints a QR); the phone scans it or you type host/port/token by hand.

Install

• iOS — TestFlight: https://testflight.apple.com/join/qWq1A51n
• Android — APK on the latest release: https://github.com/mahdi-salmanzade/odysseus-mobile/releases/latest

(You'll need an Odysseus server on your LAN with the companion bridge — setup's in the repo README.)

What makes it fully end-to-end

The basic chat loop already works on the merged companion bridge. The remaining screens (notes/tasks/memory, the in-app pairing card, push) are wired to a few open PRs — no rush at all, but a look when you have time would mean a lot:

• feat(settings): add in-app mobile pairing (Settings → Mobile) #2585 — in-app mobile pairing (Settings → Mobile)
• feat(companion): owner-scoped notes/tasks/memory behind a narrower scope + tests #881 / feat(companion): owner-scoped Deep Research launcher #1094 / feat(companion): owner-scoped notes/memory writes for the mobile client #1166 — companion data routes (notes/tasks/memory + Deep Research + writes)
• feat(companion): read-only mobile-feature endpoints (1/3) #2668 / feat(companion): mobile-feature write endpoints (2/3) #2672 / feat(companion): admin-gated mobile tools (3/3) #2674 — mobile-feature routes (read → write → admin tiers)
• feat(companion): admin-tools opt-in toggle in pairing settings #2966 — admin-tools opt-in toggle · feat(companion): mobile push — deliver owner-scoped events to a paired phone #1366 — mobile push

All target dev, CI-green, and owner-scoped. Happy to rebase or split anything however suits your review.

A note to PewDiePie 🙏

Thank you for building and open-sourcing Odysseus — a genuinely local-first, privacy-first AI workspace with no Trojan horse. This little app only exists because that one does. If folks find it useful I'll keep it in step with Odysseus and put it on the App Store so it's a one-tap install. ❤️🛶