{"id":35587295,"url":"https://github.com/syntheticautonomicmind/sam","last_synced_at":"2026-05-31T08:02:05.051Z","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-19T22:49:46.000Z","size":25934,"stargazers_count":118,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-20T00:37:08.567Z","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-19T22:49:51.000Z","dependencies_parsed_at":"2026-01-12T07:00:17.641Z","dependency_job_id":"2225b682-50e0-4122-8a81-b817c0207faf","html_url":"https://github.com/SyntheticAutonomicMind/SAM","commit_stats":null,"previous_names":["syntheticautonomicmind/sam"],"tags_count":80,"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":32362782,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"online","status_checked_at":"2026-04-28T02:00:07.250Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-05-31T08:02:05.046Z","avatar_url":"https://github.com/SyntheticAutonomicMind.png","language":"Swift","funding_links":["https://patreon.com/fewtarius"],"categories":[],"sub_categories":[],"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\nI built SAM for my wife. She wanted an AI assistant that could work with her documents, research purchases, generate images, and remember what they'd talked about. Nothing fit, so I built it. SAM was made for her - and dedicated to her.\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## What You Can Do With SAM\n\nSAM is a native macOS app for people who aren't developers. Say \"Hey SAM\" to go hands-free. Upload a PDF and ask questions about it. Research a purchase across Amazon, Walmart, and eBay in one conversation. Generate images by connecting to ALICE. All without touching a command line.\n\n**Your data stays on your Mac.** Run local models with MLX or llama.cpp and nothing leaves your machine. Switch to cloud providers when you want more capability - you choose.\n\n### Documents \u0026 Research\n\n- Upload and ask questions about PDFs, Word docs, Excel files, and text files\n- Research online with live data from Google, Bing, Amazon, Yelp, and TripAdvisor\n- Create Shared Topics to connect related conversations\n- Search your history by meaning, not just keywords\n\n### Writing \u0026 Communication\n\n- Draft emails, essays, or reports\n- Improve your writing with suggestions\n- Brainstorm ideas and organize your thoughts\n- Translate text between languages\n\n### Creativity \u0026 Design\n\n- Generate images from text descriptions via [ALICE](https://github.com/SyntheticAutonomicMind/ALICE)\n- Browse and download models from CivitAI and HuggingFace\n- Apply LoRA adapters for specific art styles\n- Train custom models on your own documents and conversations\n\n### Organization \u0026 Productivity\n\n- Manage files and folders with voice commands\n- Create project plans and task lists\n- Organize your work in project folders\n- Access SAM from your iPad or phone via [SAM-Web](https://github.com/SyntheticAutonomicMind/SAM-web)\n\n### Math \u0026 Calculations\n\n- Calculate mortgages, tips, compound interest, and ROI\n- Convert units (temperature, length, weight, volume, speed)\n- Get computed answers with Python, not AI approximation\n\n### Voice Control\n\n- \"Hey SAM\" wake word for hands-free use\n- Speech recognition and text-to-speech\n- Works offline with local models\n\n---\n\n## Personalities\n\nChoose how SAM talks to you - friendly, professional, creative, or create your own.\n\n---\n\n## Screenshots\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\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\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 product - SAM helps with research\u003c/em\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## AI Providers\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\nSwitch providers mid-conversation. Use local models for privacy, cloud models for capability. Your choice.\n\n---\n\n## Quick Start\n\n### Install\n\n**Homebrew (recommended):**\n```bash\nbrew tap SyntheticAutonomicMind/homebrew-SAM\nbrew install --cask sam\n```\n\n**Manual:** Download from [GitHub Releases](https://github.com/SyntheticAutonomicMind/SAM/releases), move to Applications, open SAM.\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 a cloud provider (enter your API key) or a local model (download from within SAM)\n\n### Start Talking\n\nPress `N` for a new conversation. Type your message. Say \"Hey SAM\" for hands-free.\n\n### Access From Other Devices\n\n[SAM-Web](https://github.com/SyntheticAutonomicMind/SAM-web) provides chat from your iPad, iPhone, or any browser. Enable API Server in SAM Preferences, then visit the SAM-Web repository for setup instructions.\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\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 MLX\n- Intel Macs can use llama.cpp models\n\n---\n\n## Privacy \u0026 Security\n\n- Conversations stored locally in `~/Library/Application Support/SAM/`\n- Per-conversation memory isolation\n- API keys stored in UserDefaults\n- Zero telemetry, zero tracking\n- When you use cloud providers, only the messages you send go to those providers\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:\n\n- **[CLIO](https://github.com/SyntheticAutonomicMind/CLIO)** - Terminal AI coding assistant (macOS, Linux, Windows)\n- **[ALICE](https://github.com/SyntheticAutonomicMind/ALICE)** - Image generation server (SAM's image engine)\n- **[SAM-Web](https://github.com/SyntheticAutonomicMind/SAM-web)** - Access SAM from any browser\n\n---\n\n## Documentation\n\n| Document | What You'll Find |\n|----------|-----------------|\n| [User Guide](docs/USER_GUIDE.md) | Getting started, daily use, tips |\n| [Features](docs/FEATURES.md) | Complete feature reference |\n| [Providers](docs/PROVIDERS.md) | AI provider setup and configuration |\n| [Tools](docs/TOOLS.md) | Built-in tools reference |\n| [Memory](docs/MEMORY.md) | How memory and search work |\n| [Security](docs/SECURITY.md) | Privacy and security model |\n| [Architecture](docs/ARCHITECTURE.md) | How SAM is built |\n| [Performance](docs/PERFORMANCE.md) | Optimization and tuning |\n| [Installation](docs/INSTALLATION.md) | Detailed install guide |\n| [BUILDING.md](BUILDING.md) | Build from source |\n| [CONTRIBUTING.md](CONTRIBUTING.md) | How to contribute |\n| [Website](https://www.syntheticautonomicmind.org) | Online guides and updates |\n\n---\n\n## License\n\n**GPL-3.0** - See [LICENSE](LICENSE) for details.\n\nCreated by Andrew Wyatt (Fewtarius) · [syntheticautonomicmind.org](https://www.syntheticautonomicmind.org) · [github.com/SyntheticAutonomicMind/SAM](https://github.com/SyntheticAutonomicMind/SAM)\n\nBuilt with open source: [Vapor](https://vapor.codes) · [MLX](https://github.com/ml-explore/mlx-swift) · [llama.cpp](https://github.com/ggerganov/llama.cpp) · [Sparkle](https://sparkle-project.org)","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"}