Skip to content

README.md

Latest commit

 

History

History
165 lines (124 loc) · 5.05 KB

README.md

File metadata and controls

165 lines (124 loc) · 5.05 KB

🌐 Nova Browser

A highly sophisticated, AI-powered desktop web browser engineered with Python and PyQt6 (QtWebEngine).

Python Version PyQt6 Platform Status

✨ Features

🤖 AI Floating Panel — Ctrl + 5

The crown feature of Nova Browser.

Press Ctrl + 5 at any time to instantly toggle a transparent floating AI assistant over any web page — no tab switching, no interruptions.

  • Instant access — one keystroke from anywhere in the browser
  • Context-aware — reads and summarizes the current page on demand
  • Multi-model routing — switch between Gemini, Groq, and local Ollama
  • Smart Selection Watcher — highlight any text for instant AI insights
  • Dismiss anytime — press Ctrl + 5 again or click outside to close

🌐 Core Browser Features

  • Multi-Tab Browsing — add, remove, and navigate tabs seamlessly
  • Bookmarks Manager — save favourite pages with persistent storage
  • Browsing History — auto-logged, searchable, with one-click clear
  • Download Manager — built-in queue with progress tracking and cancel support
  • Ad & Tracker Blocking — integrated domain filter via ad_blocker.py
  • Hardware Acceleration — Chromium core (QtWebEngine) for smooth rendering and High-DPI support

📥 Download & Run (No Python Required)

A pre-built Windows executable is ready in the output/ folder.

  1. Go to the output/ folder in this repo
  2. Click NovaBrowser.exe
  3. Click ⬇️ Download raw file (top-right of the file preview)
  4. Double-click the downloaded file to launch — no setup needed

⚠️ Windows SmartScreen may appear. Click "More info" → "Run anyway" to proceed.

💻 Developer Setup

Prerequisites

  • Python 3.11+
  • Git

1. Clone & Install

git clone https://github.com/Haseeb-code1/web-browser-.git
cd web-browser-
pip install -r requirements.txt

2. Run Locally

python main.py

Windows users can also double-click run.bat.

3. Run Tests

pytest tests/

4. Build Your Own EXE

pyinstaller --onefile --windowed main.py
# Output → dist/main.exe

Or use the provided PowerShell script:

.\build_installer.ps1

⌨️ Keyboard Shortcuts

Shortcut Action
Ctrl + 5 ✨ Toggle AI Floating Panel
Ctrl + T New Tab
Ctrl + W Close Tab
Ctrl + L Focus Address Bar
Ctrl + R Reload Page
Alt + ← Go Back
Alt + → Go Forward
Ctrl + D Bookmark Page
Ctrl + H History
Ctrl + J Downloads

🏗️ Project Structure

web-browser-/
├── main.py                     # Entry point & splash screen launcher
├── requirements.txt            # Python dependencies
├── run.bat                     # Quick launch script
├── Dockerfile                  # Containerization config
├── docker-compose.yml
│
├── scripts/
│   ├── build_installer.ps1     # Builds the .exe and installer
│   └── github_setup.py         # CI/CD and repo setup
│
└── src/
    ├── ai_assistant/           # 🧠 AI Integration Layer
    │   ├── floating_bot.py     # Floating panel logic (Ctrl + 5)
    │   ├── model_router.py     # Routes between Groq, Gemini, Ollama
    │   └── selection_watcher.py
    │
    ├── core/                   # ⚙️ Core Browser Logic
    │   ├── history.py
    │   ├── bookmarks.py
    │   └── ad_blocker.py
    │
    ├── ui/                     # 🎨 User Interface
    │   ├── browser_window.py
    │   ├── tab_manager.py
    │   ├── components/         # Toolbar, Address Bar, etc.
    │   └── dialogs/            # Downloads, History, Settings
    │
    └── utils/
        └── exception_logger.py

⚙️ Engineering Principles

Built using the Incremental Process Model — each phase delivered a stable, tested feature set:

Phase Deliverable
1 Basic navigation & Chromium rendering
2 Multi-tab support & UI components
3 Persistence — bookmarks, history, downloads
4 AI Integration — floating panel via Ctrl + 5

Lehman's Laws applied: the codebase continuously evolved from a single main.py into a modular src/ structure, with each increment unit-tested before the next phase began. Standard browser UX (tabs, address bar) was preserved throughout for familiarity.

Developed with ❤️ by Haseeb-code1