Welcome to the REopt® API Wiki! The code in this repository is the REopt API, served on developer.nrel.gov/api/reopt, which is available to the public and also acts as the back end to the REopt Web Tool. The instructions and information in this wiki are useful for:

• NREL REopt developers;
• external contributors;
• and those that wish to host the API in a local develop environment.

NOTE: For those that would like to host the API in a production environment: you can learn about how the API is structured and run in a develop environment here, but given that hosting the API in production can be done many ways and comes with cybersecurity concerns (if you expect to use any private data for example) - this documentation does not address hosting the API in production.

1. Structure of the REopt API
2. Setup for Local API Development
3. URLs to Call Locally-Hosted API
4. Developing the API (v3+)
5. Testing and Debugging in Docker with Visual Studio Code
6. Deprecated: Developing the API (v1-v2)

There are several additional REopt guides and resources for different REopt user types:

• Online REopt Web Tool (free, user-friendly interface to run REopt analyses): https://reopt.nrel.gov/
• REopt API Analysis Repo (for using, but not developing, the REopt API): https://github.com/NREL/REopt-API-Analysis/wiki
• REopt.jl Documentation (for using or developing the Julia Package): https://nrel.github.io/REopt.jl/stable/
• REopt Discussion Forum (for user questions and updates from the REopt team): https://github.com/NREL/REopt-API-Analysis/discussions
• REopt User Manual (for detailed description of the model, including mathematical documentation): https://reopt.nrel.gov/tool/reopt-user-manual.pdf

NOTE: The REopt web tool has dropped “Lite” from its name to better reflect its status as a comprehensive techno-economic optimization tool that evaluates the economics of distributed solar, wind, battery storage, combined heat and power, geothermal heat pumps, modeled greenhouse gas reductions, and more. Read about REopt's evolution.