SAM

# SAM - Synthetic Autonomic Mind

**A native macOS AI assistant that remembers, gets work done, and keeps your data on your Mac.**

Built for macOS. Built for privacy. Built for you.

SAM is a native macOS AI assistant built with Swift and SwiftUI. Unlike cloud-only alternatives, SAM keeps your data on your Mac, supports multiple AI providers (including fully local models), and provides powerful tools for autonomous task execution.

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Platform](https://img.shields.io/badge/platform-macOS%2014.0%2B-lightgrey.svg)](https://www.apple.com/macos/)
[![Swift](https://img.shields.io/badge/swift-6.0%2B-orange.svg)](https://swift.org/)

[Website](https://www.syntheticautonomicmind.org) | [Download](https://github.com/SyntheticAutonomicMind/SAM/releases) | [Part of Synthetic Autonomic Mind](https://github.com/SyntheticAutonomicMind)

---

## 🔗 Quick Links

- **Website:** [www.syntheticautonomicmind.org](https://www.syntheticautonomicmind.org)
- **Download SAM:** [Latest Release](https://github.com/SyntheticAutonomicMind/SAM/releases)
- **Documentation:** [User Guides & Tutorials](https://www.syntheticautonomicmind.org)
- **Source Code:** [GitHub Repository](https://github.com/SyntheticAutonomicMind/SAM)
- **Report Issues:** [Issue Tracker](https://github.com/SyntheticAutonomicMind/SAM/issues)
- **Support SAM:** [Patreon](https://www.patreon.com/fewtarius)

---

## Meet SAM - Your Intelligent, Hands‑Free Assistant

In July 2025, I set out to build the AI assistant my wife actually wanted: one that adapted to *her* workflow instead of forcing her to adapt. SAM was made for her - and dedicated to her. It has since grown into a native macOS assistant that anyone can use to get real work done.

A native macOS app designed for **non‑developers** who want powerful tools in their everyday life.  
Review documents, create images with [ALICE](https://github.com/SyntheticAutonomicMind/ALICE), write content, plan projects, or just have a conversation.  
Say **"Hey SAM"** to go hands‑free, or type naturally.  
You're always in control.

**Your data stays on your Mac. Always.**  
(Switch to cloud AI providers only if you want to.)

---

## Why You'll Love SAM

###  **Real Assistance, Not Just Answers**
SAM helps you finish things.  
Whether it's organizing files, helping you draft documents, or researching a topic - SAM acts on your ideas.

### **Smart Memory**
SAM remembers what matters across conversations.  
Create "Shared Topics" to connect chats around the same project, and find anything you've shared with semantic search.

###  **Just Say "Hey SAM"**
Full voice control lets you keep your hands free.  
Ask questions, give commands, or have a conversation - all without touching the keyboard.

### ️ **Create Images with ALICE**
Connect SAM to an [ALICE](https://github.com/SyntheticAutonomicMind/ALICE) server on your network for GPU-accelerated image generation.  
Automatic model discovery, multiple Stable Diffusion models, no cloud uploads.

###  **Math Without Guessing**
SAM uses real computation for math - not AI reasoning.  
Mortgages, tips, unit conversions, compound interest, ROI - all calculated with Python, not hallucinated.

###  **Access from Anywhere**
Use SAM from your iPad, iPhone, or any device with a browser.  
SAM-Web lets you chat with SAM remotely when you're away from your Mac.

###  **Privacy You Can Trust**
All your conversations, documents, and memories stay on your Mac.  
SAM works with local AI models by default, and only uses cloud AI when you choose to.

###  **No Technical Skills Needed**
Designed for everyday users - not just developers.  
SAM's clean interface and natural interactions make powerful AI accessible to everyone.

---

## What You Can Do with SAM

### **For Documents & Research**
- Upload and analyze PDFs, articles, and books
- Ask questions about your documents
- Summarize long texts in seconds
- Research online with reliable sources and citations

### **For Creativity & Design**
- Generate custom images from text descriptions
- Browse and apply different art styles
- Edit and refine images with simple prompts
- Get inspiration for projects or presentations

### **For Writing & Communication**
- Draft emails, essays, or reports
- Improve your writing with gentle suggestions
- Brainstorm ideas and organize your thoughts
- Translate text between languages

### ️**For Organization & Productivity**
- Manage files and folders with voice commands
- Create project plans and task lists
- Organize your work in project folders
- Automate repetitive computer tasks
- Access SAM remotely from your iPad or phone

### **For Math & Calculations**
- Calculate mortgages, tips, compound interest, and ROI
- Convert units (temperature, length, weight, volume, speed, data)
- Run financial formulas with exact results
- Get real computed answers, not AI approximations

### **For Learning & Curiosity**
- Ask questions about any topic
- Get step‑by‑step explanations
- Explore new skills and hobbies
- Have thoughtful, engaging conversations

---

## Features at a Glance

- **Multi‑AI support**: Choose from OpenAI, Anthropic (Claude), GitHub Copilot, DeepSeek, or run models locally (MLX, llama.cpp)
- **Voice in & out**: "Hey SAM" wake word, speech recognition, and natural text‑to‑speech
- **Image generation**: Create images via [ALICE](https://github.com/SyntheticAutonomicMind/ALICE) server with automatic model discovery
- **Math tools**: Real computation for calculations, conversions, and financial formulas
- **Remote access**: Chat with SAM from iPad, iPhone, or browser via SAM-Web
- **Document intelligence**: Upload and chat with PDFs, Word docs, Excel files, text files, and more
- **Semantic memory**: Find past conversations and documents by meaning, not just keywords
- **Project workspaces**: Keep everything organized in `~/SAM/{project‑name}/` folders
- **Personality system**: Choose from friendly, professional, creative, or custom tones
- **Dark/light mode**: Beautiful SwiftUI interface that fits your style
- **100% free & open source**: No subscriptions, no ads, no hidden costs

---

##  Screenshots

Get a glimpse of SAM's native macOS interface in action:

<table>
  <tr>
    <td width="50%">
      <h3>Natural Conversation</h3>
      <img src=".images/sam-image-1.png"/>
      <em>User greeting SAM and asking it to describe what it can help with - SAM responds with a friendly, comprehensive overview</em>
    </td>
    <td width="50%">
      <h3>Flexible AI Provider Selection</h3>
      <img src=".images/sam-image-2.png"/>
      <em>Choose from local models (MLX, llama.cpp), or cloud providers (OpenAI, Anthropic, DeepSeek, OpenRouter)</em>
    </td>
  </tr>
</table>

<table>
  <tr>
    <td width="50%">
      <h3>Travel Research</h3>
      <img src=".images/sam-image-3.png"/>
      <em>User asks about restaurants in a town they'll be visiting - SAM helps with travel planning and local recommendations</em>
    </td>
    <td width="50%">
      <h3>Shopping Assistance</h3>
      <img src=".images/sam-image-4.png"/>
      <img src=".images/sam-image-5.png"/>
      <em>User inquires about a needed product - SAM helps with product research</em>
    </td>
  </tr>
</table>



---

## What Makes SAM Different

 **Privacy First**
- All data stays on your Mac - nothing sent to the cloud unless you choose
- Run completely offline with local AI models
- API credentials stored locally in UserDefaults
- Zero telemetry, zero tracking

 **Intelligent Memory**
- Remember and search across all your conversations
- Import documents (PDF, Word, Excel, text) and ask questions about them
- Share context between conversations when you need it
- Keep conversations private from each other when you don't

 **Gets Work Done**
- Multi-step task execution - describe what you want, SAM handles the details
- Work with files, run commands, research the web
- Generate docum

[truncated…]