Built for civil servants. Designed for Ghana. Powered by AI.

OS Browser is a standalone desktop browser built specifically for Ghana's public sector. It combines a full Chromium-based browsing experience with built-in AI assistance, government portal quick-access, Twi language translation, network-level ad blocking, and government-grade privacy — all in a beautiful Ghana-inspired interface.

• Ghana flag color palette — Gold, Red, Green & Black woven into every surface
• Pre-loaded government portals — Ghana.gov, GIFMIS, CAGD, GRA, SSNIT, OHCS, E-SPAR and more
• Bookman Old Style typography — Classic, authoritative, distinguished
• Atmospheric backgrounds — Ghana colors as ambient lighting in dark & light modes

• 6 AI models — Llama 3.3 70B, DeepSeek R1, Mistral, Qwen 2.5, Gemma via Cloudflare Workers AI
• AI Sidebar — Chat, summarize pages, translate to Twi, draft letters, compare options
• AskOzzy Integration — One-click access to Ghana's sovereign AI platform
• Custom AI Agents — Create specialized assistants with custom system prompts
• Offline queue — AI requests queue when offline, process on reconnect

• Local-first architecture — All data stays on your device by default
• Encrypted database — SQLite with encryption at rest
• Network-level ad blocking — Blocks ads, trackers, and malware before they load
• Government domain whitelist — Auto-whitelists *.gov.gh to prevent breakage
• Certificate handling — Graceful handling of government site certificate issues
• Download protection — Warns on executable downloads, blocks insecure sources
• Privacy mode — Zero-trace browsing with no history, no cache, no logs

• Tab suspension — Inactive tabs auto-suspend after 5 minutes to save memory
• Max 10 concurrent tabs — Prevents memory bloat on government PCs
• Page caching — Previously visited pages available offline
• Delta auto-updates — Small patches (~5-15MB) instead of full downloads

• MSI installer — Deploy via Group Policy across government networks
• Silent install — msiexec /i OS-Browser.msi /qn
• Configurable defaults — Pre-set privacy mode, portals, and sync settings
• Bookmark import — Import from Chrome, Edge, and Firefox

┌─────────────────────────────────────────────────┐
│              OS Browser (Electron)               │
│                                                  │
│  ┌────────────────┐   ┌───────────────────────┐  │
│  │  Main Process   │   │  Renderer (React)     │  │
│  │                 │   │                       │  │
│  │  • SQLite DB    │   │  • Browser Chrome     │  │
│  │  • Ad Blocker   │   │  • AI Sidebar         │  │
│  │  • Tab Manager  │   │  • New Tab Page       │  │
│  │  • Page Cache   │   │  • Settings/Panels    │  │
│  │  • Credentials  │   │  • Zustand Stores     │  │
│  └───────┬─────────┘   └───────┬───────────────┘  │
│          │      IPC Bridge      │                  │
│          └──────────┬───────────┘                  │
└─────────────────────┼──────────────────────────────┘
                      │ HTTPS
           ┌──────────▼──────────┐
           │  Cloudflare Worker  │
           │  (Stateless AI)     │
           │  • Chat / Summarize │
           │  • Translate / Search│
           │  • No user data     │
           └─────────────────────┘

os-browser/
├── packages/
│   ├── main/          # Electron main process
│   │   └── src/
│   │       ├── db/           # SQLite + migrations + seeds
│   │       ├── ipc/          # IPC handlers (tabs, history, bookmarks, AI, settings, agents, credentials)
│   │       ├── net/          # Cloudflare client + connectivity monitor
│   │       └── services/     # Ad blocking, page cache, downloads, tray, auto-update
│   │
│   ├── renderer/      # React UI (Vite)
│   │   └── src/
│   │       ├── components/   # Browser chrome, content, sidebar, panels
│   │       ├── store/        # Zustand state (9 stores)
│   │       ├── hooks/        # Keyboard shortcuts
│   │       └── styles/       # Ghana design system (CSS variables)
│   │
│   ├── preload/       # Secure IPC bridge (contextBridge)
│   └── shared/        # Types, models, constants, IPC channels
│
├── worker/            # Cloudflare AI microservice
│   └── src/
│       ├── routes/          # AI chat, summarize, translate, search, compare
│       ├── middleware/      # Device auth, rate limiting
│       └── services/       # Workers AI wrapper with model fallback
│
└── docs/              # Design spec + implementation plan

• Node.js 18+
• npm 9+
• Git

# Clone the repository
git clone https://github.com/ghwmelite-dotcom/OS-Browser.git
cd OS-Browser

# Install dependencies
npm install

# Build all packages
npm run build

# Start the renderer dev server
cd packages/renderer && npx vite

# In another terminal, launch Electron
cd OS-Browser
NODE_ENV=development npx electron packages/main/dist/main.js

# Update wrangler.toml with your Cloudflare resource IDs
cd worker
npx wrangler deploy

# Build Windows .exe installer
npm run package:exe

# Build .msi for enterprise deployment
npm run package:msi

• v1.1 — Cloud sync (bookmarks, tabs, settings via Cloudflare D1)
• v1.1 — Ga and Ewe language translation
• v1.2 — Dagbani, Hausa, Fante translation
• v1.2 — Ghana NLP Khaya API integration for better Twi quality
• v2.0 — macOS and Linux builds
• v2.0 — Browser extension support

Proprietary — Hodges & Co. Limited / ohwpstudios

Built with ❤️ in Accra, Ghana
_{Hodges & Co. Limited / ohwpstudios}