embedded-browser-app
v1.0.0
Published
A localhost application with embedded web browser
Maintainers
Readme
Bug Bounty Bot - Embedded Browser with AI Assistant
A desktop application for bug bounty hunting with an embedded web browser and AI-powered security analysis assistant.
Features
- Embedded Chromium Browser: Full-featured browser embedded in the center panel
- AI Chat Assistant: Cursor-style chat interface powered by Google Gemini
- Security Tools Panel: Access to repeater, scanner, intercept, proxy, and more
- Request Interceptor: Burp Suite-style proxy bar for monitoring requests
- Real-time AI Analysis: Get security insights and vulnerability suggestions
Installation
- Install dependencies:
npm install- Set up your Google Gemini API key:
- Copy
env.exampleto.env:cp env.example .env - Edit
.envand add your Google Gemini API key:GOOGLE_API_KEY=your_actual_api_key_here - Get your API key from: https://makersuite.google.com/app/apikey
- Copy
Usage
- Start the application:
npm startThe browser will load
http://localhost:3000by default. You can change this in the URL bar.Use the AI Assistant:
- Type your questions in the chat panel on the right
- Ask about security vulnerabilities, testing strategies, or request analysis
- The AI will provide security-focused responses
Navigate to any URL:
- Enter a URL in the address bar
- Press Enter or click "Go"
- Use the Back/Forward buttons to navigate history
- Click Reload to refresh the page
UI Layout
- Top Bar: Request interceptor (Burp Suite style) showing recent requests
- Left Sidebar: Security tools (Repeater, Scanner, Intercept, Proxy, etc.)
- Center Panel: Embedded browser with navigation controls
- Right Sidebar: AI chat assistant interface
Notes
- The browser view is embedded within the Electron window
- You can navigate to localhost URLs (e.g.,
localhost:3000,localhost:8080) - You can also navigate to any public website
- The AI assistant uses Google Gemini API for responses
- Make sure your
.envfile is properly configured with a valid API key
