Skip to main content
Use this guide when you’re installing the opensre binary yourself — on a laptop, a shared VM, or a machine in your own network.

​
Which setup fits you?

Platform steps:

​
1. Install the CLI

On Windows (PowerShell):
You usually don’t need sudo. The installer puts opensre somewhere already on your PATH when it can. If it can’t, it uses ~/.local/bin and prints how to add that to PATH. Auto setup: In a normal interactive terminal, install often starts opensre setup when it finishes. In CI or scripts it skips that. To turn auto-setup off:
GitHub CLI: The installer also tries to install gh if it’s missing (OpenSRE’s GitHub tools need it). Skip that with:
Homebrew installs pull in gh automatically. Shorter overview: Install OpenSRE.

​
2. Sign in

The browser opens the OpenSRE sign-up page. Create an account or sign in using email or another enabled provider; a successful login activates the hosted model. Setup opens the shell only after the webapp validates that account session. GitHub remains an optional integration you can add later. When developing the webapp locally on port 3000, use:
To remain signed out, cancel setup or choose Exit and stay signed out when opensre shows the account gate. Other CLI commands remain available; the interactive shell does not.

​
3. Open the shell

The shell revalidates the webapp account on every start. Expired, revoked, incomplete, or unreachable account state returns to the sign-in gate instead of constructing the REPL or a model client.

​
Where credentials are saved

OpenSRE saves non-secret identity and hosted-model metadata in owner-only account metadata. The account token uses the local secret store and is not written to account.json; integration credentials are stored separately. OPENSRE_ACCOUNT_TOKEN overrides the saved account token when set. Never commit it to .env or source control. Run opensre account logout to revoke the saved session; an environment override must be unset separately.

​
4. Check your tools

Inside the shell:
One tool only:
From a normal terminal, prefix with opensre (for example opensre integrations verify).

​
5. Ask a first question

Start the shell and describe what’s going on in plain English:
Ask: why is checkout latency spiking? The agent calls the tools you connected and answers in the shell.

​
Where to connect tools

The full tool list lives under Integrations, not Install. Start at Integrations overview, then open each provider page for keys, permissions, and examples.
  • Quickstart — install + setup + sample run with GIFs
  • Deployment — gateway and hosted options beyond a single laptop