docs: Add installation, architecture, and API documentation

Author: Soul Browser

docs/API.md

@@ -0,0 +1,86 @@
+# Soul Browser API Reference
+
+## SoulBrowser Class
+
+```python
+from soulbrowser import SoulBrowser
+
+browser = SoulBrowser(
+    headless=False,
+    proxy=None,
+    fingerprint_protection=True
+)
+```
+
+### Methods
+
+#### new_page()
+Create a new browser page.
+
+```python
+page = browser.new_page()
+```
+
+#### close()
+Close the browser.
+
+```python
+browser.close()
+```
+
+## Page Methods
+
+### Navigation
+
+```python
+page.goto("https://example.com")
+page.reload()
+page.go_back()
+page.go_forward()
+```
+
+### Interaction
+
+```python
+page.click("button#submit")
+page.fill("input[name=email]", "test@example.com")
+page.select("select#country", "US")
+```
+
+### Privacy
+
+```python
+page.enable_fingerprint_protection()
+page.set_proxy("socks5://localhost:9050")
+page.enable_tor()
+```
+
+### Media
+
+```python
+page.mute_all()
+page.enable_pip()
+page.set_playback_rate(1.5)
+```
+
+## Events
+
+```python
+page.on("request", lambda req: print(req.url))
+page.on("response", lambda res: print(res.status))
+```
+
+## Async API
+
+```python
+import asyncio
+from soulbrowser import AsyncSoulBrowser
+
+async def main():
+    browser = AsyncSoulBrowser()
+    page = await browser.new_page()
+    await page.goto("https://example.com")
+    await browser.close()
+
+asyncio.run(main())
+```

docs/ARCHITECTURE.md

@@ -0,0 +1,63 @@
+# Soul Browser Architecture
+
+## Overview
+
+Soul Browser is built on a modular architecture that separates concerns into distinct components.
+
+```
+soulbrowser/
+├── browser.py          # Core browser engine
+├── config.py           # Configuration management
+├── download.py         # Binary download manager
+├── geoip.py           # GeoIP handling
+├── accessibility/      # Accessibility features
+├── adblock/           # Ad blocking engine
+├── ai/                # AI-powered features
+├── automation/        # Browser automation
+├── devtools/          # Developer tools
+├── human/             # Human-like behavior simulation
+├── media/             # Media handling
+├── network/           # Network layer
+├── performance/       # Performance optimization
+├── privacy/           # Privacy protection
+├── security/          # Security features
+├── session/           # Session management
+├── ui/                # UI components
+└── web3/              # Web3 integration
+```
+
+## Core Components
+
+### Browser Engine
+- Chromium-based rendering
+- Multi-process architecture
+- GPU acceleration
+
+### Privacy Module
+- Fingerprint protection
+- Cookie isolation
+- Tracking prevention
+
+### Network Module
+- HTTP/3 support
+- Proxy management
+- DNS-over-HTTPS
+
+### Session Module
+- Tab management
+- Workspace organization
+- State persistence
+
+## Data Flow
+
+1. User request → Browser Engine
+2. Network interception → Privacy filters
+3. Content rendering → Security checks
+4. Response → User
+
+## Extension Points
+
+- Custom filter lists
+- User scripts
+- Themes
+- Plugins

docs/INSTALL.md

@@ -0,0 +1,99 @@
+# Soul Browser Installation Guide
+
+## Quick Install
+
+```bash
+pip install soulbrowser
+```
+
+## Platform-Specific Instructions
+
+### Windows
+
+**Using pip:**
+```bash
+pip install soulbrowser
+```
+
+**Using pipx (recommended for CLI):**
+```bash
+pipx install soulbrowser
+```
+
+### macOS
+
+```bash
+pip install soulbrowser
+# or with Homebrew Python
+python3 -m pip install soulbrowser
+```
+
+### Ubuntu/Debian
+
+```bash
+sudo apt update
+sudo apt install python3-pip
+pip3 install soulbrowser
+```
+
+### Fedora
+
+```bash
+sudo dnf install python3-pip
+pip3 install soulbrowser
+```
+
+### Arch Linux
+
+```bash
+pip install soulbrowser
+```
+
+### Kali Linux
+
+```bash
+pip3 install soulbrowser
+```
+
+## From Source
+
+```bash
+git clone https://github.com/vikrant-project/soulbrowser.git
+cd soulbrowser
+pip install -e .
+```
+
+## Docker
+
+```bash
+docker pull soulbrowser/soulbrowser
+docker run -it soulbrowser/soulbrowser
+```
+
+## Verify Installation
+
+```bash
+python -c "import soulbrowser; print(soulbrowser.__version__)"
+```
+
+## Dependencies
+
+Soul Browser automatically installs required dependencies:
+- playwright
+- aiohttp
+- cryptography
+- And more...
+
+## Troubleshooting
+
+### Browser binary not found
+
+```bash
+python -m soulbrowser install
+```
+
+### Permission errors on Linux
+
+```bash
+sudo chown -R $USER:$USER ~/.soulbrowser
+```