Your intelligent macOS assistant that performs actual tasks
Sam is a native macOS AI assistant that represents a new paradigm of human-computer interaction. Unlike traditional AI assistants that only provide instructions, Sam actually performs tasks through deep system integration and natural language commands.
- 🎯 Task Execution: Actually performs tasks vs. instruction-giving
- 🔒 Privacy-First: Local processing with minimal cloud dependencies
- 🍎 Native Integration: Deep macOS system and app integration
- 🧠 Contextual Intelligence: Learns and adapts to user workflows
- 💬 Real-time Streaming: Character-by-character response streaming
- ✏️ Message Management: Edit and delete messages with full history
- 🎨 Modern UI: Native SwiftUI interface with accessibility support
- macOS 13.0 (Ventura) or later
- Xcode 15.0 or later
- Apple Silicon or Intel Mac
- Clone the repository:
git clone https://github.com/sayemrihan/sam-macos-ai-assistant.git
cd sam-macos-ai-assistant- Open the project in Xcode:
open Sam/Sam.xcodeproj- Build and run the project (⌘R)
- Grant necessary permissions when prompted
- Configure your AI preferences in Settings
- Start chatting with Sam!
"Copy file.pdf to Desktop"
"Organize my Downloads folder"
"Find all .txt files in Documents"
"What's my battery level?"
"Show me storage usage"
"List running applications"
"Open Safari and go to apple.com"
"Close all Chrome windows"
"Switch to Finder"
"Create a workflow to backup my photos"
"Set up a daily reminder at 9 AM"
"Automate my morning routine"
Sam is built with a modern, privacy-first architecture:
- Frontend: Native SwiftUI with MVVM pattern
- AI Processing: Hybrid local/cloud processing
- Data Storage: Core Data with encryption
- System Integration: Native macOS APIs and AppleScript
- Performance: <200MB memory baseline, <2s response time
Sam/
├── Models/ # Data models and Core Data
├── Views/ # SwiftUI views and UI components
├── Managers/ # Business logic and state management
├── Services/ # External integrations and system APIs
├── Utils/ # Helper functions and extensions
└── Resources/ # Assets and configurations
- Install dependencies:
# Install SwiftLint for code quality
brew install swiftlint
# Install SwiftFormat for consistent formatting
brew install swiftformat- Run code quality checks:
swiftlint lint --config .swiftlint.yml
swiftformat Sources/ --config .swiftformat- Build and test:
xcodebuild -project Sam.xcodeproj -scheme Sam -configuration Debug build
xcodebuild test -project Sam.xcodeproj -scheme Sam -destination 'platform=macOS'We welcome contributions! Please see our Contributing Guidelines for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Run tests and code quality checks
- Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Sam is designed with privacy as a core principle:
- Local Processing: 80%+ of tasks processed locally
- Minimal Cloud Data: Only complex queries sent to external services
- No Training Data: Your data is never used for AI model training
- Encryption: Local data encrypted at rest
- Transparency: Full control over data sharing preferences
See our Project Roadmap for upcoming features and improvements.
- Documentation: Wiki
- Issues: GitHub Issues
- Discussions: GitHub Discussions
This project is licensed under the MIT License - see the LICENSE file for details.
Sayem Abdullah Rihan
- GitHub: @sayemrihan
- Email: [email protected]
- Apple for the excellent macOS development frameworks
- The Swift community for amazing tools and libraries
- Beta testers and early adopters for valuable feedback
Made with ❤️ by Sayem Abdullah Rihan