Kigali Sim

New File Load File Save File Guide Get Help

Open Analysis

Note that this will override code currently entered into the application.

Open Cancel

Configure Custom Emissions Metric

Select which emission types to include in your custom metric:

Apply Cancel

Configure Custom Sales/Consumption Metric

Select which consumption types to include in your custom metric:

Apply Cancel

Update Available

A new version of Kigali Sim is available!

Your current simulation changes have been saved automatically. You can reload now to use the latest version, or continue with the current version. The updated version will be automatically loaded on your next visit.

For more information about changes made, see the beta change log on GitHub.

Note: your software is showing as up to date but you may update anyway.

Loading indicator Please wait...
Update Now Update Later

Your Privacy is Protected

By default, no data or simulation configurations are shared with others, including the development team. All simulations and supporting simulation data are saved only within your computer, specifically inside your browser. Use the Save and Load buttons to store simulations long term and to send simulations to others.

That said, if you would like our help, simulations can be sent to the University of California team using the Get Help feature. This can be used to facilitate support when you request it or provide feedback.

Except for the Get Help feature or directly sending a QTA file to us (like by email), we do not have visibility into your data or simulations. For more details, see our Privacy Policy.

Close

AI Assistant

AI assistants can help you build Kigali Sim simulations by reading and writing QubecTalk code. You can use any AI assistant. For example, we use Claude.

Getting Started:

  • Direct your AI assistant to read our documentation at https://kigalisim.org/llms-full.txt?v=20250928 (default recommendation). For access to even more documentation, you can also include https://kigalisim.org/llms.txt?v=20250928.
  • Copy your QubecTalk code from the editor and provide it to the AI.
  • Ask the AI to help modify or enhance your simulation.
  • Copy the AI's code suggestions back into the editor. We recommend asking it to provide the complete updated code for the simulation.

Version Parameters: The version parameter (e.g., ?v=20250928) is optional but recommended. It helps ensure your AI assistant accesses the latest documentation by avoiding cached versions. You can use the URLs with or without the version parameter.

Tip: For LLMs which cannot access the internet, you can download llms-full.txt and provide it as an attachment to your AI assistant.

Note: Using AI assistants is entirely optional. Their use is subject to their respective terms of service and privacy policies.

Close

AI Assistant

AI assistants can help you build more sophisticated Kigali Sim simulations by working with QubecTalk code. You can use any AI assistant. For example, we use Claude.

To use AI assistance:

  1. Learn about the code-based interface in Tutorial 7
  2. Switch to the Editor tab above to access the code interface
  3. Click the AI Assistant button at the bottom of the editor for detailed instructions

The code-based interface allows AI assistants to help you create complex scenarios, implement policies, and perform advanced analysis that goes beyond the visual designer.

Close

Duplicate Entity

Create a copy of an existing entity with a new name.

Finish Cancel

Welcome to Kigali Sim

Kigali Sim is an interactive, open source tool that simulates substances and equipment related to the Montreal Protocol and Kigali Amendment. It can also explore different policy interventions.

This software provides an easy-to-use interface where you can enter country-level modeling data and policies under consideration to quickly simulate potential impacts on emissions, energy, substance consumption, and equipment across multiple scenarios. This can be used to explore many different substances like HFCs and sectors like commercial refrigeration. You can also use QubecTalk, a simple programming language that unlocks advanced modeling capabilities.

Kigali Sim was built to support researchers and policy makers like those working on Kigali Implementation Plans. It is offered as a free, open source project that prioritizes your agency and privacy. Our tool does not share your simulations and data with others, including the tool's development team, unless you specifically request it. You don't need to install anything to use Kigali Sim - it can work in your web browser. However, you can also install it to your desktop or use a Java Virtual Machine to run simulations.

We want to help and hear from you! If you have any questions, suggestions, requests, or just want to talk to us about Kigali Sim, you can reach us at hello@kigalisim.org. Need help getting started? Check out our User's Guide. Currently in beta testing.

Loading indicator Loading please wait...

Simulation

Applications

    Add Application

    Application

    An application is a type of use which may be compatible with many different substances. For example, an application may be "commercial ACs" for commercial air conditioners.
    Finish Cancel

    Consumption

      Add Consumption

      Consumption

      A consumption records describes use of a single substance like HFC-134a in a single application like domestic refrigeration.
      Information about the substance and application being modeled.
      lookup
      Information about equipment that uses this substance for this application. You are describing equipment using for . Change
      Substance levels at specific times. These typically describe initial values for assessing consumption. For example, amount of import and domestic manufacturing (both produced and consumed within the country) at the start of the simulation. Note: use change instead to describe relative changes over time.
      Add Setpoint
      You are making set points for used in . Change
      How sales or consumption change over time like, for example, how much domestic manufacture increases each year. While this sets streams to change relatively over time, use setpoints instead to have consumption, sales, etc be specific values at specific times.
      Add Change
      You are describing changes in used for . Change
      Specify limits (minimum and maximum). Optionally, these limits can displace other substances or streams. For example, in a 100 kg cap on HFC-134a offsetting R-410A in domestic refrigeration, a cap would cause 150 kg of HFC-134a and 0 kg of R-410A to become 100 and 50 kg respectively.
      Add Limit
      You are limiting used for . Change
      Specify multiple recharge operations for equipment servicing. This can be used for both "top up" operations (smaller amounts) and "repair" operations (amounts closer to initial charge). Multiple recharge commands can be specified per substance/application pair.
      Add Recharge
      You are servicing used for . Change
      Finish Cancel

      Policies

        Add Policy

        Policy

        Policies can modify substances within applications. They can also be combined into a package tested in a simulation.
        Information about the name of the policy as well as its the target substance and application. This is the substance being limited, recycled, or replaced with something else.
        Define a recycling program in which substance is recovered during servicing. There may be yield loss in processing substances prior to reuse.
        Add Recycling
        Your policy will recycle used for . Change
        Specify replacement of the policy's target substance with another compatible substance. For example, this could be used to model a retrofit program.
        Add Replacement
        Your policy will replace used for . Change
        Set streams such as imports or equipment to specific levels. These set points could be used to model a mandate for a specific year. For example, an import value set to 0 colud indicate a probition on foreign HFC-134a.
        Add Level
        Your policy will add set points used for . Change
        Make relative changes to streams such as imports or equipment continually over a period of time. For example, this could be used to model a subsidy or incentive program.
        Add Change
        Your policy will change used for . Change
        Impose limits like to overall sales in a specific application. Optionally, these caps can displace other substances or streams. For example, a 100 kg cap on A offsetting B would cause 150 kg of A and 0 kg of B to become 100 and 50 kg respectively. For example, this could be used to model a permit scheme like in domestic refrigeration.
        Add Limit
        Your policy will limit used for . Change
        Modify equipment servicing schedules under this policy. This can be used to model regulatory requirements for more frequent servicing to reduce leakage, changes to recharge volumes, or other policy-driven modifications to service operations. For example, a policy might require reduced top-up volumes to encourage proper repairs. Note that recharge percentages are additive: 10% recharge in BAU plus 5% recharge in policy equals 15% overall servicing.
        Add Servicing
        Your policy will modify servicing for used for . Change
        Finish Cancel

        Simulations

          Add Simulation

          Simulation

          Simulations are collections of policies. If no policies are selected, this will simulate business as usual (no policy interventions).
          Finish Cancel

          Substances Table

          Download spreadsheet software-compatible files that contain tables describing all substances and applications in your simulation. Alternatively, bulk import spreadsheets with substance information. We recommend that you download the current file, modify it, and re-upload to make changes. Please use the widely-supported CSV file format. Note: the key column is used to indicate which existing substance to modify with updated information but can be left blank if it is a new substance.

          Substances: 0
          Import / Export Substances Duplicate AI Assistant
          Need more control? Switch to the code-based advanced editor.
          The analysis you are currently working on uses features not available in the basic editor. Instead, switch to the code-based advanced editor.
          Loading please wait...

          Results

          configure custom
          configure custom
          Showing summed by as .
          Filter for .
          0
          0
          0
          Export Spreadsheet