Iran Amplifier
Add to Firefox

Developer Guide

Want to test the latest unreleased changes or contribute to development? This guide shows you how to load Iran Amplifier directly from source in Firefox.

Most users should install from Firefox Add-ons instead.

1 Load the Development Version

Download the latest code from GitHub and load it as a temporary add-on in Firefox.

  1. Download the source

    Go to the releases page and download the latest .zip file, or clone the repository:

    git clone https://github.com/4iranorg/amplifier-ext.git

  2. Open Firefox debugging

    Type about:debugging in Firefox's address bar and press Enter.

  3. Load the extension

    Click "This Firefox" in the sidebar, then click "Load Temporary Add-on".

  4. Select the manifest

    Navigate to the extension folder and select the manifest.json file.

Note: Temporary add-ons are removed when Firefox closes. You'll need to reload the extension each time you restart Firefox.

2 Get an API Key

An API key is like a password that lets the extension use AI services. You'll need one from either OpenAI or Anthropic.

Option A: OpenAI

  1. Go to platform.openai.com and create an account
  2. Navigate to API Keys
  3. Click "Create new secret key"
  4. Copy the key (starts with sk-)

Option B: Anthropic

  1. Go to console.anthropic.com and create an account
  2. Navigate to API Keys
  3. Click "Create Key"
  4. Copy the key (starts with sk-ant-)
Cost: AI services charge per response. Typical cost is 1–5 cents per response. Both services require adding payment information, but you only pay for what you use.

3 First-Time Setup

When you first install the extension, a setup wizard will guide you through configuration.

  1. Review privacy notice

    The extension explains how your data is handled. TL;DR: Everything stays on your device.

  2. Choose your talking points

    Select which facts and human rights issues the AI can reference in responses.

  3. Choose calls to action

    Select which policy demands you want to advocate for.

  4. Enter your API key

    Paste the API key you copied earlier. This is stored locally on your device only.

That's it! You're ready to start amplifying voices for Iranian freedom.

4 Using the Extension

  1. Go to X (Twitter)

    Open x.com in Firefox.

  2. Find a post about Iran

    Look for posts discussing Iranian civil society, human rights, or related topics.

  3. Click the Amplify button

    You'll see an "Amplify" button appear near posts. Click it to generate response suggestions.

  4. Review and post

    Choose a response, edit if you like, then click Reply or Quote to post. You're always in control.

Need Help?

If you run into issues, check the GitHub Issues page or open a new issue describing your problem.