Installs GSA's AI engineering tools on your Windows PC with one double-click:
- Pi: an AI assistant that uses GSA's USAi models
- GitHub Copilot on USAi (optional)
- AI usage dashboard: see your AI sessions and how much you have used
Everything runs privately on your PC inside Ubuntu, a Linux system that Windows runs in the background (WSL).
- Windows 10 or 11, with local administrator rights
- The GSA network or VPN
- A USAi API key (from the USAi website)
- A GitHub account (optional; only for pull requests)
- 10 GB of free disk space and about 30 minutes
- On this page, click the green Code button, then Download ZIP.
- Unzip the file, open the folder, and double-click Install Engineer. If Windows says "Windows protected your PC", click More info, then Run anyway.
- If Windows asks to turn on WSL, click Yes. If it asks you to restart, restart, then double-click Install Engineer again.
- Create an Ubuntu user name and password when asked. They are separate from your Windows login. Remember the password: the installer asks for it.
- Answer the installer's questions. Pressing Enter accepts the default, which is fine. It asks which optional tools you want.
- Paste your USAi key when asked (right-click pastes; the key stays hidden), then press Enter.
The first install takes about 20 minutes. If it stops, fix what the message says and double-click Install Engineer again; it continues where it left off.
Find them in Start menu > Engineer. The first three are also on your desktop.
| Shortcut | What it does |
|---|---|
| Pi (AI assistant) | Opens Pi |
| Update USAi key | Replaces your USAi key |
| AI usage dashboard | Shows your AI usage in your browser |
| Copilot (AI assistant) | Opens Copilot on USAi (only if you chose it) |
| Check Engineer | Finds problems and tells you how to fix them |
| Update Engineer | Installs the latest version |
| Remove Engineer | Uninstalls Engineer (keeps your data unless you choose otherwise) |
Do this whenever you get a new key or your old one expires.
- Copy your new key from the USAi website.
- Double-click Update USAi key.
- Right-click to paste the key (it stays hidden), then press Enter.
- Close and reopen any open Pi or Copilot windows.
USAi checks the key before it is saved. If USAi rejects it, nothing changes.
- Open Check Engineer and follow what it says.
- Double-click Install Engineer again.
- Still stuck? Send the team a screenshot of the message. Never include your USAi key in a screenshot or message.
This repository is a thin Windows wrapper around
GSA/the_engineer, which it installs
into ~/engineer inside Ubuntu (24.04 or newer, WSL 2). engineer-ref.txt
chooses the_engineer branch, tag or commit for the first install; Update
Engineer then follows the_engineer main. Everything else, including the
command line (~/engineer/engineer), is documented there.