{"id":35587295,"url":"https://github.com/syntheticautonomicmind/sam","last_synced_at":"2026-04-20T00:13:46.529Z","repository":{"id":329744467,"uuid":"1120133815","full_name":"SyntheticAutonomicMind/SAM","owner":"SyntheticAutonomicMind","description":"Synthetic Autonomic Mind - An AI assistant for everyone.","archived":false,"fork":false,"pushed_at":"2026-04-10T11:39:09.000Z","size":26930,"stargazers_count":108,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-10T13:28:12.545Z","etag":null,"topics":["ai-assistant","ai-assistants","ai-tools","apple","apple-silicon","artificial-intelligence","copilot-enabled","llamacpp","llm","local-llm","macos","mlx","openai","oss","stable-diffusion","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SyntheticAutonomicMind.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"patreon":"fewtarius"}},"created_at":"2025-12-20T15:01:37.000Z","updated_at":"2026-04-10T11:39:14.000Z","dependencies_parsed_at":"2026-01-12T07:00:17.641Z","dependency_job_id":null,"html_url":"https://github.com/SyntheticAutonomicMind/SAM","commit_stats":null,"previous_names":["syntheticautonomicmind/sam"],"tags_count":70,"template":false,"template_full_name":null,"purl":"pkg:github/SyntheticAutonomicMind/SAM","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntheticAutonomicMind%2FSAM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntheticAutonomicMind%2FSAM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntheticAutonomicMind%2FSAM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntheticAutonomicMind%2FSAM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SyntheticAutonomicMind","download_url":"https://codeload.github.com/SyntheticAutonomicMind/SAM/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SyntheticAutonomicMind%2FSAM/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31706765,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-12T06:22:27.080Z","status":"ssl_error","status_checked_at":"2026-04-12T06:21:52.710Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","ai-assistants","ai-tools","apple","apple-silicon","artificial-intelligence","copilot-enabled","llamacpp","llm","local-llm","macos","mlx","openai","oss","stable-diffusion","swift"],"created_at":"2026-01-04T22:18:17.600Z","updated_at":"2026-04-12T07:01:46.949Z","avatar_url":"https://github.com/SyntheticAutonomicMind.png","language":"Swift","readme":"# SAM - Synthetic Autonomic Mind\n\n**A native macOS AI assistant that remembers, gets work done, and keeps your data on your Mac.**\n\nBuilt for macOS. Built for privacy. Built for you.\n\nSAM 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.\n\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Platform](https://img.shields.io/badge/platform-macOS%2014.0%2B-lightgrey.svg)](https://www.apple.com/macos/)\n[![Swift](https://img.shields.io/badge/swift-6.0%2B-orange.svg)](https://swift.org/)\n\n[Website](https://www.syntheticautonomicmind.org) | [Download](https://github.com/SyntheticAutonomicMind/SAM/releases) | [Part of Synthetic Autonomic Mind](https://github.com/SyntheticAutonomicMind)\n\n---\n\n## 🔗 Quick Links\n\n- **Website:** [www.syntheticautonomicmind.org](https://www.syntheticautonomicmind.org)\n- **Download SAM:** [Latest Release](https://github.com/SyntheticAutonomicMind/SAM/releases)\n- **Documentation:** [User Guide](docs/USER_GUIDE.md) · [Features](docs/FEATURES.md) · [All Docs](docs/)\n- **Source Code:** [GitHub Repository](https://github.com/SyntheticAutonomicMind/SAM)\n- **Report Issues:** [Issue Tracker](https://github.com/SyntheticAutonomicMind/SAM/issues)\n- **Security:** [Security Policy](SECURITY.md)\n- **Support SAM:** [Patreon](https://www.patreon.com/fewtarius)\n\n---\n\n## Meet SAM - Your Intelligent, Hands‑Free Assistant\n\nIn 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.\n\nA native macOS app designed for **non‑developers** who want powerful tools in their everyday life.  \nReview documents, create images with [ALICE](https://github.com/SyntheticAutonomicMind/ALICE), write content, plan projects, or just have a conversation.  \nSay **\"Hey SAM\"** to go hands‑free, or type naturally.  \nYou're always in control.\n\n**Your data stays on your Mac. Always.**  \n(Switch to cloud AI providers only if you want to.)\n\n---\n\n## Why You'll Love SAM\n\n###  **Real Assistance, Not Just Answers**\nSAM helps you finish things.  \nWhether it's organizing files, helping you draft documents, or researching a topic - SAM acts on your ideas.\n\n### **Smart Memory**\nSAM remembers what matters across conversations.  \nCreate \"Shared Topics\" to connect chats around the same project, and find anything you've shared with semantic search.\n\n###  **Just Say \"Hey SAM\"**\nFull voice control lets you keep your hands free.  \nAsk questions, give commands, or have a conversation - all without touching the keyboard.\n\n### ️ **Create Images with ALICE**\nConnect SAM to an [ALICE](https://github.com/SyntheticAutonomicMind/ALICE) server on your network for GPU-accelerated image generation.  \nAutomatic model discovery, multiple Stable Diffusion models, no cloud uploads.\n\n###  **Math Without Guessing**\nSAM uses real computation for math - not AI reasoning.  \nMortgages, tips, unit conversions, compound interest, ROI - all calculated with Python, not hallucinated.\n\n###  **Access from Anywhere**\nUse SAM from your iPad, iPhone, or any device with a browser.  \nSAM-Web lets you chat with SAM remotely when you're away from your Mac.\n\n###  **Privacy You Can Trust**\nAll your conversations, documents, and memories stay on your Mac.  \nSAM works with local AI models by default, and only uses cloud AI when you choose to.\n\n###  **No Technical Skills Needed**\nDesigned for everyday users - not just developers.  \nSAM's clean interface and natural interactions make powerful AI accessible to everyone.\n\n---\n\n## What You Can Do with SAM\n\n### **For Documents \u0026 Research**\n- Upload and analyze PDFs, articles, and books\n- Ask questions about your documents\n- Summarize long texts in seconds\n- Research online with reliable sources and citations\n\n### **For Creativity \u0026 Design**\n- Generate custom images from text descriptions\n- Browse and apply different art styles\n- Edit and refine images with simple prompts\n- Get inspiration for projects or presentations\n\n### **For Writing \u0026 Communication**\n- Draft emails, essays, or reports\n- Improve your writing with gentle suggestions\n- Brainstorm ideas and organize your thoughts\n- Translate text between languages\n\n### ️**For Organization \u0026 Productivity**\n- Manage files and folders with voice commands\n- Create project plans and task lists\n- Organize your work in project folders\n- Automate repetitive computer tasks\n- Access SAM remotely from your iPad or phone\n\n### **For Math \u0026 Calculations**\n- Calculate mortgages, tips, compound interest, and ROI\n- Convert units (temperature, length, weight, volume, speed, data)\n- Run financial formulas with exact results\n- Get real computed answers, not AI approximations\n\n### **For Learning \u0026 Curiosity**\n- Ask questions about any topic\n- Get step‑by‑step explanations\n- Explore new skills and hobbies\n- Have thoughtful, engaging conversations\n\n---\n\n## Features at a Glance\n\n- **Multi-AI support**: Choose from OpenAI, GitHub Copilot, Google Gemini, DeepSeek, MiniMax, OpenRouter, or run models locally (MLX, llama.cpp). Claude models available via GitHub Copilot and OpenRouter.\n- **Voice in \u0026 out**: \"Hey SAM\" wake word, speech recognition, and natural text‑to‑speech\n- **Image generation**: Create images via [ALICE](https://github.com/SyntheticAutonomicMind/ALICE) server with automatic model discovery\n- **Math tools**: Real computation for calculations, conversions, and financial formulas\n- **Remote access**: Chat with SAM from iPad, iPhone, or browser via SAM-Web\n- **Document intelligence**: Upload and chat with PDFs, Word docs, Excel files, text files, and more\n- **Semantic memory**: Find past conversations and documents by meaning, not just keywords\n- **Project workspaces**: Keep everything organized in `~/SAM/{project‑name}/` folders\n- **Personality system**: Choose from friendly, professional, creative, or custom tones\n- **Dark/light mode**: Beautiful SwiftUI interface that fits your style\n- **100% free \u0026 open source**: No subscriptions, no ads, no hidden costs\n\n---\n\n##  Screenshots\n\nGet a glimpse of SAM's native macOS interface in action:\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003eNatural Conversation\u003c/h3\u003e\n      \u003cimg src=\".images/sam-image-1.png\"/\u003e\n      \u003cem\u003eUser greeting SAM and asking it to describe what it can help with - SAM responds with a friendly, comprehensive overview\u003c/em\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003eFlexible AI Provider Selection\u003c/h3\u003e\n      \u003cimg src=\".images/sam-image-2.png\"/\u003e\n      \u003cem\u003eChoose from local models (MLX, llama.cpp), or cloud providers (OpenAI, GitHub Copilot, Google Gemini, DeepSeek, MiniMax, OpenRouter)\u003c/em\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003eTravel Research\u003c/h3\u003e\n      \u003cimg src=\".images/sam-image-3.png\"/\u003e\n      \u003cem\u003eUser asks about restaurants in a town they'll be visiting - SAM helps with travel planning and local recommendations\u003c/em\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\"\u003e\n      \u003ch3\u003eShopping Assistance\u003c/h3\u003e\n      \u003cimg src=\".images/sam-image-4.png\"/\u003e\n      \u003cimg src=\".images/sam-image-5.png\"/\u003e\n      \u003cem\u003eUser inquires about a needed product - SAM helps with product research\u003c/em\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\n\n---\n\n## What Makes SAM Different\n\n **Privacy First**\n- All data stays on your Mac - nothing sent to the cloud unless you choose\n- Run completely offline with local AI models\n- API credentials stored locally in UserDefaults\n- Zero telemetry, zero tracking\n\n **Intelligent Memory**\n- Remember and search across all your conversations\n- Import documents (PDF, Word, Excel, text) and ask questions about them\n- Share context between conversations when you need it\n- Keep conversations private from each other when you don't\n\n **Gets Work Done**\n- Multi-step task execution - describe what you want, SAM handles the details\n- Work with files, run commands, research the web\n- Generate documents and images\n- Handle complex projects autonomously\n\n️ **Powerful Tools**\n- Read, edit, and search files\n- Research and browse the web\n- Work with Git repositories\n- Generate images via ALICE server\n- Compute math with real Python calculations\n\n **Image Generation (ALICE)**\n- Connect to remote GPU-accelerated Stable Diffusion server\n- Automatic model discovery and selection\n- No local GPU required - offload to dedicated hardware\n- Multiple model support (SD 1.5, SDXL, and more)\n\n **Math \u0026 Calculations**\n- Real computation via Python - not AI guessing\n- Financial formulas (mortgage, compound interest, ROI, budgets)\n- Unit conversions (temperature, length, weight, volume, speed)\n- Percentage calculations, tips, BMI, and more\n\n **Access Anywhere**\n- Use SAM from your iPad, iPhone, or any device with a browser\n- Web interface (SAM-Web) provides chat and basic features remotely\n- Connect over your local network (requires SAM running on Mac)\n- Secure API authentication\n\n **Flexible AI Provider Support**\n- **Cloud AI**: OpenAI, GitHub Copilot, Google Gemini, DeepSeek, MiniMax, OpenRouter (Claude models available via GitHub Copilot and OpenRouter)\n- **Local Models**: Run AI completely on your Mac with MLX or llama.cpp\n- Switch models mid-conversation\n- Use custom OpenAI-compatible endpoints\n\n---\n\n## Quick Start\n\n### Download \u0026 Install\n\n**Option 1: Using Homebrew (Recommended)**\n\n```bash\nbrew tap SyntheticAutonomicMind/homebrew-SAM\nbrew install --cask sam\n```\n\nTo update SAM in the future, simply run:\n```bash\nbrew upgrade --cask sam\n```\n\n**Option 2: Manual Download**\n\n1. **Download** the latest release from [GitHub Releases](https://github.com/SyntheticAutonomicMind/SAM/releases)\n2. **Extract** the downloaded zip file\n3. **Move** `SAM.app` to your Applications folder\n4. **First Launch**: Right-click SAM.app -\u003e Open (macOS Gatekeeper requirement, only needed once)\n\n### Set Up Your AI Provider\n\n1. Launch SAM\n2. Open Settings (`,`)\n3. Go to **AI Providers** tab\n4. Click **Add Provider**\n5. Choose your provider:\n  - **Cloud AI**: OpenAI, Claude, GitHub Copilot, Google Gemini, DeepSeek, MiniMax, or OpenRouter\n  - **Local Model**: Choose a model to download and run on your Mac\n6. For cloud providers: Enter your API key\n7. Save and start chatting!\n\n### Start Your First Conversation\n\nPress `N` to create a new conversation, type your message, and press Enter. SAM will respond and can help you with questions, writing, coding, research, file management, and much more.\n\n### Access SAM from Other Devices\n\nWant to use SAM from your iPad or phone? Check out **[SAM-Web](https://github.com/SyntheticAutonomicMind/SAM-web)** - a web interface that provides chat functionality and basic features when you're away from your Mac.\n\n**What you need:**\n1. SAM running on your Mac with API Server enabled (Preferences -\u003e API Server)\n2. Get your API token from the same preferences pane\n3. Visit the [SAM-Web repository](https://github.com/SyntheticAutonomicMind/SAM-web) for setup instructions\n4. Connect from your browser at `http://your-mac-ip:8080`\n\n**Note:** SAM-Web provides chat, mini-prompts, and conversation basics. Advanced features require the native macOS app.\n\n---\n\n## Get Started in Minutes\n\n[Download SAM](https://github.com/SyntheticAutonomicMind/SAM/releases/latest) for macOS 14.0+  \n[Read the guides](https://www.syntheticautonomicmind.org)  \n[View the code](https://github.com/SyntheticAutonomicMind/SAM)  \n[Share feedback](https://github.com/SyntheticAutonomicMind/SAM/issues)\n\n---\n\n## Development Program\n\nSAM offers a development channel for users who want early access to new features and are willing to help test pre-release builds.\n\n### What are Development Builds?\n\nDevelopment builds are released frequently (sometimes daily) and contain:\n- New features before they reach stable release\n- Bug fixes and improvements being tested\n- Potentially incomplete features or breaking changes\n\n**Development builds are intended for testing and feedback only.** They may contain bugs or unstable behavior. Do not use development builds for critical production work.\n\n### How to Enable Development Updates\n\n1. Open SAM Preferences (`,`)\n2. Go to the **General** tab\n3. Enable **\"Receive development updates\"**\n4. Confirm the warning about potential instability\n5. SAM will now check for both development and stable releases\n\nYou can disable development updates at any time to return to stable releases only.\n\n### Development vs Stable Releases\n\n| Feature | Stable Releases | Development Releases |\n|---------|----------------|----------------------|\n| **Version Format** | `YYYYMMDD.RELEASE` (e.g., `20260110.1`) | `YYYYMMDD.RELEASE-dev.BUILD` (e.g., `20260110.1-dev.1`) |\n| **Release Frequency** | Weekly or bi-weekly | Daily or multiple per day |\n| **Testing** | Fully tested and documented | Pre-release testing |\n| **Stability** | Production-ready | May contain bugs |\n| **Who Gets Them** | All users by default | Only users who opt-in |\n\n### Providing Feedback\n\nIf you're using development builds and encounter issues:\n1. Check [GitHub Issues](https://github.com/SyntheticAutonomicMind/SAM/issues) to see if it's already reported\n2. Create a new issue with:\n  - Your SAM version (shown in About SAM or Preferences)\n  - Steps to reproduce the problem\n  - Expected vs actual behavior\n  - Relevant logs (Help -\u003e Show Logs)\n\nYour feedback helps make SAM better for everyone!\n\n---\n\n## Key Features\n\n### Conversations\n\n- Unlimited conversations with automatic saving\n- Export to JSON or Markdown\n- Rename, duplicate, and organize conversations\n- Switch AI models mid-conversation\n\n### Memory \u0026 Documents\n\n- Search across all your conversations semantically\n- Import documents (PDF, Word, Excel, text files) and ask questions about them\n- Search by filename and content with enhanced metadata\n- Share context between conversations when needed\n- Keep conversations private from each other by default\n\n### AI Provider Support\n\n| Provider | What You Get |\n|----------|--------------|\n| **OpenAI** | GPT-4, GPT-4o, GPT-3.5, o1/o3 models |\n| **Anthropic** | Claude models available via GitHub Copilot and OpenRouter |\n| **GitHub Copilot** | GPT-4o, Claude 3.5, o1 (requires subscription) |\n| **DeepSeek** | Cost-effective AI models |\n| **Google Gemini** | Gemini 2.5 Pro/Flash, large context windows |\n| **MiniMax** | MiniMax-M2.7, M2.5 (128K context) |\n| **OpenRouter** | Access 100+ models from multiple providers |\n| **Local MLX** | Run models on Apple Silicon Macs |\n| **Local llama.cpp** | Run models on any Mac (Intel or Apple Silicon) |\n| **Custom** | Use any OpenAI-compatible API |\n\n### ️What SAM Can Do\n\n**Work with Files**\n- Read, write, search, and edit files\n- Find files by name or content\n- Get file information\n\n**Execute Commands**\n- Execute shell scripts\n\n**Research \u0026 Web**\n- Search the web (Google, Bing, and more)\n- Scrape and analyze web pages\n- Gather and synthesize information from multiple sources\n\n**Development Tools**\n- Git operations (commit, diff, status)\n- Build and run tasks\n- Search code and check for errors\n\n**Documents \u0026 Images**\n- Import and analyze PDF, Word, Excel, and text files\n- Create formatted documents (PDF, Word, PowerPoint)\n- Generate images via ALICE server\n\n**Math \u0026 Calculations**\n- Mortgages, compound interest, tips, ROI, budgets\n- Unit conversions (temperature, length, weight, volume, speed, data)\n- Real Python computation - no hallucinated math\n\n### Image Generation (ALICE)\n\nConnect to a remote [ALICE](https://github.com/SyntheticAutonomicMind/ALICE) server for GPU-accelerated image generation:\n\n- **Automatic Model Discovery**: SAM detects available models on your ALICE server\n- **Multiple Models**: SD 1.5, SDXL, and any model loaded on your server\n- **Health Monitoring**: Connection status and server health displayed in preferences\n- **No Local GPU Required**: Offload generation to dedicated hardware on your network\n\n### SAM-Web: Remote Access\n\nAccess SAM chat from other devices on your network:\n\n- **Web Interface**: Chat with SAM from your browser (requires SAM running on Mac)\n- **Multi-Device Support**: Use from iPad, iPhone, tablets, or other computers\n- **Core Features**: Conversations, mini-prompts, model selection, and chat\n- **Responsive Design**: Optimized for desktop, tablet, and mobile screens\n- **Secure Access**: Token-based authentication\n- **Easy Setup**: No installation on remote device, just open browser\n- **All Features Available**: Chat, tools, settings, prompts, and more\n\nVisit the [SAM-Web repository](https://github.com/SyntheticAutonomicMind/SAM-web) for setup instructions.\n\n### Personalities\n\nChoose from built-in personalities to customize how SAM communicates:\n\n- **General Purpose**: SAM (default), Generic, Concise\n- **Tech \u0026 Development**: Developer, Architect, Code Reviewer, Tech Buddy\n- **Domain Experts**: Doctor, Counsel, Finance Coach, Scientist, Philosopher\n- **Creative Writing**: Creative Catalyst, DocuGenie, Prose Pal\n- **Productivity**: Fitness Fanatic, Motivator\n- **Fun Characters**: Comedian, Pirate, Time Traveler, Jester\n\nAnd many more! You can also create custom personalities.\n\n---\n\n## System Requirements\n\n**To Use SAM:**\n- macOS 14.0 (Sonoma) or later\n- 4GB RAM minimum (8GB+ recommended)\n- 3GB free disk space for the app\n\n**For Local AI Models:**\n- 16GB+ RAM recommended\n- 20GB+ free disk space (models can be large)\n- Apple Silicon (M1/M2/M3/M4) recommended for best performance with MLX\n- Intel Macs can use llama.cpp models\n\n---\n\n## Privacy \u0026 Security\n\n### Your Data Stays on Your Mac\n\n- **Conversations**: Stored locally in `~/Library/Application Support/SAM/`\n- **Memory**: Per-conversation databases, never shared between conversations\n- **API Keys**: Stored in UserDefaults for provider credentials\n- **No Telemetry**: Zero usage tracking, zero data collection\n\nWhen you use cloud AI providers (OpenAI, Claude, etc.), only the messages you send go to those providers. SAM never sends telemetry or analytics anywhere.\n\n### Security Features\n\n- Authorization system for file operations\n- Per-conversation memory isolation prevents data leakage\n- Optional auto-approve for operations you trust\n- Full audit trail of all actions\n\n---\n\n## Where SAM Stores Your Data\n\n### Your Conversations and Settings\n```\n~/Library/Application Support/SAM/\n├── conversations/              # Your conversation files\n├── config.json                 # App settings\n└── conversations/{id}/\n    └── memory.db              # Memories for each conversation\n```\n\n### Downloaded AI Models\n```\n~/Library/Caches/sam-rewritten/models/\n└── {model-name}/              # Individual model files\n```\n\n### Working Files\n```\n~/SAM/\n├── conversation-{number}/     # Working files for each conversation\n└── {topic-name}/              # Shared workspace for topics\n```\n\n### Generated Images\n```\n~/Library/Caches/sam/images/   # Images downloaded from ALICE server\n```\n\n---\n\n## Part of the Ecosystem\n\nSAM is part of [Synthetic Autonomic Mind](https://github.com/SyntheticAutonomicMind) - a family of open source AI tools that work together:\n\n- **[CLIO](https://github.com/SyntheticAutonomicMind/CLIO)** - AI code assistant for the terminal. Runs on macOS and Linux.\n- **[MIRA](https://github.com/SyntheticAutonomicMind/MIRA)** - Native graphical terminal for CLIO. Runs on macOS, Linux, and Windows.\n- **[ALICE](https://github.com/SyntheticAutonomicMind/ALICE)** - GPU-accelerated image generation server. Offload Stable Diffusion to dedicated hardware.\n- **[SAM-Web](https://github.com/SyntheticAutonomicMind/SAM-web)** - Access SAM from your iPad, iPhone, or any browser.\n\nSAM can use ALICE for image generation and CLIO can use SAM as an AI provider. All three share the same providers and the same commitment to privacy.\n\n---\n\n## Spread the Word\n\nSAM is a small open source project with no marketing budget. Word of mouth is how projects like this grow. If SAM has been useful to you, the best way to help is to tell someone about it - a blog post, a tweet, a recommendation to a colleague, or a star on GitHub.\n\n---\n\n## Contributing\n\nWe welcome contributions! To contribute:\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/your-feature`\n3. Make your changes\n4. Test your changes\n5. Commit with clear messages\n6. Push and create a pull request\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.\n\n---\n\n## Getting Help\n\n### Having Trouble?\n\n**SAM won't open after downloading?**\n```bash\n# Remove macOS quarantine attribute\nxattr -d com.apple.quarantine /Applications/SAM.app\n```\n\n**Model not showing up in the model list?**\n- Check that models are in `~/Library/Caches/sam/models/mlx/` or `~/Library/Caches/sam/models/gguf/`\n- Restart SAM after adding new models\n\n**API key issues?**\n- Verify your API key in Settings -\u003e AI Providers\n- Check that your API key is active on the provider's website\n- Review any error messages in the conversation\n\n### Need More Help?\n\n- **Documentation**: [Website](https://www.syntheticautonomicmind.org) and [project-docs/](project-docs/)\n- **Report Issues**: [GitHub Issues](https://github.com/SyntheticAutonomicMind/SAM/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/SyntheticAutonomicMind/SAM/discussions)\n\n---\n\n## Technical Details\n\nSAM is built with:\n- **Swift 6** with strict concurrency\n- **SwiftUI** for native macOS interface\n- **Vapor** for embedded HTTP/SSE server\n- **SQLite** for conversation and memory storage\n- **MLX** for Apple Silicon AI models\n- **llama.cpp** for cross-platform AI models\n- **Python** for math computation and tool execution\n\nFor developers interested in the technical architecture, see [project-docs/](project-docs/).\n\n---\n\n## Building from Source\n\nFor developers who want to build SAM from source, see [BUILDING.md](BUILDING.md) for complete instructions.\n\n---\n\n## Documentation\n\nComplete documentation is available:\n\n- **[User Guide](docs/USER_GUIDE.md)** - Getting started and using SAM\n- **[Features](docs/FEATURES.md)** - Complete feature reference\n- **[Architecture](docs/ARCHITECTURE.md)** - How SAM is built\n- **[Providers](docs/PROVIDERS.md)** - AI provider setup guide\n- **[Tools](docs/TOOLS.md)** - Built-in tools reference\n- **[Memory](docs/MEMORY.md)** - Memory and search system\n- **[Security](docs/SECURITY.md)** - Privacy and security model\n- **[Installation](docs/INSTALLATION.md)** - Installation guide\n- **[Performance](docs/PERFORMANCE.md)** - Performance and optimization\n- **[BUILDING.md](BUILDING.md)** - Build from source\n- **[CONTRIBUTING.md](CONTRIBUTING.md)** - How to contribute\n- **[project-docs/](project-docs/)** - Internal technical specifications\n- **[Website](https://www.syntheticautonomicmind.org)** - Online guides\n\n---\n\n## License \u0026 Credits\n\n**License:** GPL-3.0 - See [LICENSE](LICENSE) for details\n\n**Created by:** Andrew Wyatt (Fewtarius)  \n**Website:** [syntheticautonomicmind.org](https://www.syntheticautonomicmind.org)  \n**Repository:** [github.com/SyntheticAutonomicMind/SAM](https://github.com/SyntheticAutonomicMind/SAM)\n\n**Built with open source:**\n- [Vapor](https://vapor.codes) - Web framework\n- [MLX](https://github.com/ml-explore/mlx-swift) - Apple machine learning\n- [llama.cpp](https://github.com/ggerganov/llama.cpp) - LLM inference\n- [Sparkle](https://sparkle-project.org) - App updates\n\nSpecial thanks to contributors and the Swift/AI communities.\n\n","funding_links":["https://patreon.com/fewtarius","https://www.patreon.com/fewtarius"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyntheticautonomicmind%2Fsam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsyntheticautonomicmind%2Fsam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsyntheticautonomicmind%2Fsam/lists"}