Ostler Documentation#
Ostler is a local-first personal AI assistant. The Hub runs on your Mac and holds your knowledge graph, your conversations, and the AI model that answers from them. An optional iOS app lets you reach the Hub from your phone. Your personal data stays on your hardware – not a server, not a cloud account, not us.
This site is the technical entry point. Marketing copy lives at ostler.ai. What you will find here:
- How to install the Hub and pair Ostler on iPhone
- The 4-artefact conversation spec, AI conversations, the wiki, and Doctor
- How the architecture is laid out and what data crosses which boundary
- Configuration, environment variables, the local API, and the CLI
- Plain-English answers about privacy, hardware, and updates
- Diagnostic flows for the things that go wrong
Status
Ostler is generally available. These docs track the latest released Hub and iOS app. If you need an answer that is not here yet, see Contact.
What Ostler does
- Historical data ingest at install time. iMessage, WhatsApp, Safari, Chrome, and Apple Mail history are all mined during install, so the wiki and timeline are populated on first launch. See first run – pick which Mac sources to learn from.
- Proactive iOS app. Suggestions, life timeline, stale contacts, birthdays, and "today" cards on iPhone, powered by the Hub's local endpoints.
- A considered visual design across Hub, Doctor, Wiki, and the iOS app.
- Recovery key reveal at end of install. Copy to Keychain, save as PDF, or print – on a dedicated screen, with no other path to retrieve it later.
- Sparkle auto-update. Signed, licence-tied Hub updates.
For the detail on what each release changed, see the Changelog.
Start here#
-
Getting Started
Install the Hub, run through first-time setup, and pair the iOS app. About 30 minutes of hands-on time.
-
Features
The 4-artefact conversation spec, AI conversation capture, the personal wiki, and the Doctor dashboard – the things the product actually does.
-
Architecture
How the Hub and the iOS app split responsibilities, where encryption sits, and which data flows are local versus public.
-
Privacy
What stays on your device, what (narrowly) leaves it for public lookups, and what we never collect.
-
Reference
Configuration files, environment variables, the local HTTP API, and the command-line tools.
-
Troubleshooting
Symptoms, causes, and fixes for common install and runtime issues. Start here when something is not working.
-
FAQ
The questions we get asked most. Hardware, privacy, pricing, updates, platform support, and the honest answers.
-
Integrations
Tools that work cleanly with Ostler's visible-zone vault. Start with Obsidian for a graph view, plugins, and mobile access to your indexed life.
Quick links#
- Pair the iOS app
- Data exports – request and import platform data
- Widgets and Watch complications
- What happens on first run
- Conversations: the 4-artefact spec
- AI conversations: Claude Code + ChatGPT capture
- The personal wiki
- Doctor – the Hub dashboard
- Voice and speaker identification
- Encryption design
- Apple Mail vs Google OAuth
- Changelog
- Contact and support