Add comprehensive README with architecture docs

README.md

@@ -1,3 +1,40 @@
-# alfred-browser
+# Alfred Browser
 
-Privacy-first Chromium fork with Kyber-1024, ad blocking, anti-fingerprinting.
+Privacy-first web browser built on Electron with post-quantum encryption, WebTorrent P2P distribution, and AI integration.
+
+## Features
+
+- **Post-quantum encryption**: Kyber-1024 (ML-KEM-1024) key exchange
+- **MAC randomization**: Per-session hardware address rotation
+- **Built-in P2P**: WebTorrent-enabled for decentralized content delivery
+- **AI tools**: 500+ MCP tools accessible from browser context
+- **Cross-platform**: Linux (.deb, .rpm, .AppImage), Windows (portable .zip), macOS (Intel + Apple Silicon), Android (.apk)
+
+## Build Artifacts
+
+| Platform | Format | Size |
+|----------|--------|------|
+| Linux x64 | AppImage | 159 MB |
+| Linux x64 | .deb | 113 MB |
+| Linux x64 | .rpm | 115 MB |
+| Windows x64 | .zip | 167 MB |
+| macOS Intel | .zip | 154 MB |
+| macOS ARM64 | .zip | 148 MB |
+| Android | .apk | 89 MB |
+
+## Architecture
+
+Built with Electron + Chromium. Custom preload scripts inject:
+- Post-quantum TLS negotiation
+- MAC address cycling on network change
+- WebTorrent client for P2P downloads
+- Sovereign DNS resolution via Handshake (HSD)
+
+## Downloads
+
+- [alfredlinux.com/apps](https://alfredlinux.com/apps)
+- [gositeme.com/apps](https://gositeme.com/apps)
+
+## License
+
+AGPL-3.0 — GoSiteMe Inc.