The Sessions way of working
Decide what you want to do, gather the material it needs, wrap it in a persona, then start a session. Set it up once and every chat begins with the right context.
Set up for a class or project
If you're a student, create one persona per class and load its reading into a knowledge base. Every chat with that persona can then draw on the material — without anything being uploaded.
-
1
Create a persona for the class
In Settings → Personas, add a persona named for the course (e.g. “Biology 101”). Give it a system prompt like “You are my biology study partner.”
-
2
Add the reading to its knowledge base
Open the persona's Knowledge base and add your textbooks and notes — pick local files, or paste a URL to fetch and convert a reading on-device.
-
3
Start a chat with that persona
New chats use the active persona, so the model can search that material as it answers — “Quiz me on chapter 3” or “Explain meiosis using my notes.”
-
4
Attach anything one-off
For a single assignment, attach the PDF directly to the chat instead of adding it to the knowledge base. Attachments live with that chat only.
Have a conversation
The fastest way to start. Pick a model once, then chat as much as you like.
-
1
Choose and download a model
In Settings, pick a model from the catalog. Smaller models respond faster; larger ones handle more complex tasks but need more storage.
-
2
Start a new chat and send
Type your message and send. The model runs on your device, so the first reply may take a moment as it loads.
-
3
Regenerate or cancel anytime
Not happy with a reply? Regenerate to try again. Mid-generation, tap Stop — the partial reply is discarded so you can edit and resend.
Every chat is saved as a plain Markdown file — in the Files app on iOS, or Documents/Sessions-AI on Mac. Open, copy, or back them up with any tool.
Ground answers in your own documents
Add documents to a knowledge base and the assistant searches them locally, then grounds its answer in what it finds. Nothing is uploaded.
-
1
Add files or fetch a URL
In the persona's Knowledge base, add text, Markdown, or PDF files — or paste a URL and Sessions will fetch and convert it on-device.
-
2
Sessions indexes it locally
Documents are chunked and indexed with on-device full-text search. Saving re-chunks and re-embeds the document.
-
3
Ask, and check what was used
Relevant chunks are added to the prompt as context. “Last retrieval” in Settings shows which of your documents informed the most recent answer.
Take action with tools
Ask in plain language and the model reaches for on-device tools — no setup required. A few things to try:
Calendar, reminders, and contacts use your device's own data with your permission. See the tools reference for the full list.
Create images
Switch the composer to Image mode and describe what you want. Generation runs locally — your prompts and pictures never reach a server.
-
1
Download an image model
In the model catalog, choose an image model (e.g. SDXL). Image models are larger, so they need more storage and memory.
-
2
Switch to Image mode and describe it
Toggle the composer to Image, then describe your picture — “A watercolor sunset over the bay.” Tune size, steps, and seed in generation defaults.
Models
Sessions runs open language and image models locally. Browse the in-app catalog (powered by Hugging Face), download what you need, and remove models to free space. See the full model catalog.
- Text models — pick by size and capability. Smaller is faster; larger handles complex reasoning.
- Image models — for Image mode. Larger downloads, more memory needed.
- Storage — models range from hundreds of MB to several GB. Keep only the ones you use.
Personas
A persona is an assistant identity with its own setup. Switch the active persona to change which one new chats use.
Custom instructions that shape how it responds.
Each persona has its own document set.
Per-persona tool servers, configured separately.
Knowledge base
Per-persona document storage that grounds answers in your content. Add text, Markdown, or PDF files, or fetch a URL — everything is chunked and indexed on-device with full-text search. Nothing is uploaded.
The knowledge base is per-persona — switch personas and you switch document sets. Use chat attachments for one-off files you don't want indexed.
Tools reference
Math and conversions like “5 miles to km.”
List, add, complete, or delete — on-device.
Optional (DuckDuckGo). Only the query is sent.
Pull content from a URL or look up an article.
Read/write clipboard, search contacts, open Maps.
Multi-step plans for complex projects.
macOS only: file search (Spotlight), Mail drafts, Apple Notes, screen capture, and opening apps. These tools aren't offered on iOS.
MCP servers
Model Context Protocol lets you connect third-party servers that expose extra tools — a database query or code-execution tool, for example. Add MCP server URLs per-persona in Settings; Sessions connects over HTTP and registers their tools.
Third parties: MCP servers you add are outside our control. Review each server's documentation and privacy policy before connecting it.
Settings & sampling
- Max tokens — the maximum length of each reply.
- Temperature — higher is more creative; lower is more focused.
- Advanced sampling — top-k, top-p, min-p, typical-p, repetition penalty, mirostat, and more.
- Web search toggle — turn DuckDuckGo search on or off.
Privacy & data
All processing runs on your device. Chats, the knowledge base, and model data stay on your iPhone, iPad, or Mac.
Read the full Privacy Policy for details.