https://github.com/nuance-dev/Web
https://github.com/nuance-dev/Web
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/nuance-dev/Web
- Owner: nuance-dev
- License: other
- Created: 2025-07-20T21:16:29.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2025-07-24T19:16:07.000Z (4 months ago)
- Last Synced: 2025-07-25T00:42:53.741Z (4 months ago)
- Language: Swift
- Size: 2.9 MB
- Stars: 10
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-mac - Web - 为 macOS 打造的极简 AI 浏览器，基于 SwiftUI。 [![Freeware][Freeware Icon] ![Open-Source Software][OSS Icon]](https://github.com/nuance-dev/Web) (浏览器 / 其他)
- awesome-swift-macos-apps - Web - dev/Web?label=" /> <img align="bottom" height="13" src="https://img.shields.io/github/last-commit/nuance-dev/Web?style=flat&label=" /> - A tiny AI-powered browser built with SwiftUI, fast, private, and Apple Silicon only. (Browser)
- trackawesomelist - Web (⭐416) - Minimal AI browser for macOS, built with SwiftUI. [ ](https://github.com/nuance-dev/Web) (Recently Updated / [Jul 29, 2025](/content/2025/07/29/README.md))
- awesome-mac - Web - 为 macOS 打造的极简 AI 浏览器，基于 SwiftUI。 [![Freeware][Freeware Icon] ![Open-Source Software][OSS Icon]](https://github.com/nuance-dev/Web) (浏览器 / 其他)
- awesome-mac - Web - 为 macOS 打造的极简 AI 浏览器，基于 SwiftUI。 [![Freeware][Freeware Icon] ![Open-Source Software][OSS Icon]](https://github.com/nuance-dev/Web) (浏览器 / 其他)
README
# Web - macOS AI Browser
Built natively with SwiftUI to delivers a minimal, progressive browsing experience with integrated AI capabilities.
*_Note: This is an experimental early access version, as AI models improve so will Web._*
*_Note 2: The AI features require an Apple M chip._*
*_Note 3: The current version is meant to be used to play around and give feedback to gear development. It's missing key features as a browser._*
## What's working
https://github.com/user-attachments/assets/e16842f8-fc2a-4984-91ee-9b012bd792f5
### Core Browsing
- **WebKit Integration**: Native WebKit rendering with WKWebView
- **Tab Management**: Tab hibernation for optimal performance
- **Keyboard Shortcuts**: Comprehensive shortcuts (⌘T, ⌘W, ⌘R, etc.)
- **Downloads**: Built-in download manager with progress tracking (Need to test)
### Privacy & Security
- **Incognito Mode**: Private browsing sessions
- **Ad Blocking**: Integrated ad blocking service (Need to test if it can be disabled)
- **Password Management**: Secure password handling (Need to test)
- **Privacy Settings**: Granular privacy controls (Need to test)
### AI Integration
- **Local AI Models**: On-device AI powered by [Apple MLX](https://github.com/ml-explore/mlx) and [MLX Swift Examples](https://github.com/ml-explore/mlx-swift-examples)
- **MLX Framework**: Apple Silicon optimized inference
- **Privacy-First**: AI processing happens locally on device
- **Smart Assistance**: Integrated AI sidebar for web content analysis with TL;DR and page + history context. (Still rough with bugs, but nice to play and have fun)
## Requirements
- macOS 14.0 or later
- Apple Silicon Mac (for AI features)
- Xcode 15.0+ (for development)
## Installation
### From Source
1. Clone the repository:
```bash
git clone https://github.com/nuance-dev/Web.git
cd Web
```
2. Open the project in Xcode:
```bash
open Web.xcodeproj
```
3. Build and run (⌘R)
## Architecture
Web follows MVVM architecture with SwiftUI and Combine:
```
Web/
├── Models/ # Data models (Tab, Bookmark, etc.)
├── Views/ # SwiftUI views and components
├── ViewModels/ # Business logic and state management
├── Services/ # Core services (Download, History, etc.)
├── AI/ # Local AI integration
└── Utils/ # Utilities and extensions
```
### Key Components
- **TabManager**: Handles tab lifecycle and hibernation
- **WebView**: SwiftUI wrapper around WKWebView
- **MLXRunner**: Local AI model execution
- **DownloadManager**: File download handling
- **BookmarkService**: Bookmark management
## AI Features
Web integrates local AI capabilities using Apple's MLX framework and Swift examples:
- **Framework**: [Apple MLX](https://github.com/ml-explore/mlx) with [MLX Swift Examples](https://github.com/ml-explore/mlx-swift-examples)
- **Models**: Gemma and other compatible models
- **Inference**: MLX-optimized for Apple Silicon
- **Privacy**: All AI processing happens locally
### Code Standards
- Swift 6 with strict concurrency
- Zero warnings/errors policy
- Comprehensive keyboard shortcuts
- Memory-efficient tab management
## Contributing
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## Keyboard Shortcuts
| Action | Shortcut | Description |
|--------|----------|-------------|
| New Tab | ⌘T | Open new tab |
| Close Tab | ⌘W | Close current tab |
| Reopen Tab | ⇧⌘T | Reopen last closed tab |
| Reload | ⌘R | Reload current page |
| Address Bar | ⌘L | Focus address bar |
| Find in Page | ⌘F | Search in page |
| Downloads | ⇧⌘J | Show downloads |
| Developer Tools | ⌥⌘I | Open developer tools |
| Toggle Top Bar | ⇧⌘H | Cycle top bar modes |
| Toggle Sidebar | ⌘S | Sidebar vs Top tabs |
| Open AI Panel | ⇧⌘A | Open AI Sidebar |
## Dependencies
- [Apple MLX](https://github.com/ml-explore/mlx) - Machine learning framework for Apple Silicon
- [MLX Swift Examples](https://github.com/ml-explore/mlx-swift-examples) - Swift examples and utilities for MLX
- WebKit - Apple's web rendering engine
- Core Data - Local data persistence
- Combine - Reactive programming framework
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- [Apple MLX](https://github.com/ml-explore/mlx) by Apple for optimized machine learning on Apple Silicon
- [MLX Swift Examples](https://github.com/ml-explore/mlx-swift-examples) by Apple for Swift integration examples
- Apple's WebKit team for the excellent web rendering engine
- The Swift community for SwiftUI and modern iOS/macOS development patterns
## 🔗 Links
- Website: [Nuanc.me](https://nuanc.me)
- Report issues: [GitHub Issues](https://github.com/nuance-dev/Web/issues)
- Follow updates: [@Nuanced](https://x.com/Nuancedev)
- [Buy me a coffee](https://buymeacoffee.com/nuanced)