IMPORTANT: Full functionality requires a proxy and socket server running locally with mitmproxy Python package. See Installation Guide for setup instructions. The live demo may have limited functionality without local setup.

Installation Guide

Complete setup guide for the FIG ecosystem with mitmproxy integration and Firefox configuration

Prerequisites

Required Software

Python 3.8+required
Node.js 18+required
mitmproxyrequired
Firefox browserrequired

Optional Components

Lighthouse API keyoptional

Important Warnings

Proxy Required

This system requires mitmproxy running locally to intercept HTTP traffic

Certificate Installation

Firefox must trust mitmproxy certificates for HTTPS traffic

Service Dependencies

WebSocket bridge and backend services must be running simultaneously

Quick Start Steps

1

Install mitmproxy

Set up the Python proxy tool

2

Configure Firefox

Set proxy and install certificates

3

Run Services

Start all required components

mitmproxy Installation

Install mitmproxy on your system to enable HTTP traffic interception

🪟

Windows

Install via pip or download the installer

pip install mitmproxy
# Or download from mitmproxy.org
mitmproxy --version
🍎

macOS

Use Homebrew or pip for installation

brew install mitmproxy
# Or via pip
pip install mitmproxy
🐧

Linux

Install via pip or system package manager

pip install mitmproxy
# Or via package manager
sudo apt install mitmproxy

Verification Steps

Check Installation

mitmproxy --version

This should display the mitmproxy version number

Test Basic Functionality

mitmproxy --help

This should show available commands and options

Next Steps

Once mitmproxy is installed, you'll need to:

  • Configure Firefox to use mitmproxy as a proxy
  • Install mitmproxy certificates in Firefox
  • Set up the FIG application scripts

Firefox Configuration

Configure Firefox to use mitmproxy and install the necessary certificates for HTTPS traffic

1

Open Firefox Settings

Navigate to the network settings in Firefox

  • Open Firefox browser
  • Click the hamburger menu (☰) in the top-right corner
  • Select "Settings" from the dropdown menu
  • Click on "General" in the left sidebar
  • Scroll down to "Network Settings" section
2

Configure Proxy Settings

Set up manual proxy configuration

  • Click "Settings..." next to "Network Settings"
  • Select "Manual proxy configuration"
  • Set HTTP Proxy to: 127.0.0.1
  • Set Port to: 8080
  • Check "Use this proxy server for all protocols"
  • Click "OK" to save settings
3

Install mitmproxy Certificate

Add mitmproxy CA certificate to Firefox

  • Start mitmproxy: mitmproxy --host
  • In Firefox, navigate to: http://mitm.it
  • Click "Get mitmproxy-ca-cert.pem" for Firefox
  • Download the certificate file
  • Go to Firefox Settings > Privacy & Security > Certificates
  • Click "View Certificates..."
  • Go to "Authorities" tab and click "Import..."
  • Select the downloaded certificate file
  • Check "Trust this CA to identify websites"
  • Click "OK" and restart Firefox

Important Notes

  • Always start mitmproxy before configuring Firefox proxy settings
  • Restart Firefox after installing the certificate to ensure it takes effect
  • Only use this setup for development and testing purposes

Troubleshooting

Certificate not trusted

Make sure to check "Trust this CA to identify websites" when importing the certificate

HTTPS sites not loading

Verify the certificate is properly installed and Firefox is restarted

Proxy connection failed

Ensure mitmproxy is running on port 8080 before configuring Firefox

Certificate download fails

Make sure mitmproxy is running and accessible at http://mitm.it

Service Setup

Instructions for setting up all required services.

Troubleshooting

Common issues and solutions for the FIG ecosystem.