## Get started
Install the CLI on macOS or Linux, then launch OpenResearch:
```sh
curl -LsSf https://openresearch.sh/install.sh | sh
orx up
```
`orx up` opens the local dashboard at `http://127.0.0.1:4791`.
On a managed Mac (for example, a work computer), use the macOS download above
instead. Device-management policies may block the CLI that `install.sh`
installs because it is not yet signed. The app is signed with a Developer ID
and notarized by Apple. To use `orx` in your terminal, click **Install** under
**Install the `orx` command** in the app's Settings → Updates, or run (adjusting
the path if the app is not in `/Applications`):
```sh
/Applications/OpenResearch.app/Contents/MacOS/orx install-cli
```
Either way, `orx` is linked into `~/.local/bin`, with a hint to add it to your
`PATH` if needed. If you already ran `install.sh`, remove `~/.cargo/bin/orx`
first and open a new terminal.
On Windows, use the beta download above after installing
[Git for Windows](docs/windows.md). It installs for your account, with no
administrator prompt. The installer isn't signed yet, so Windows may say
"Windows protected your PC": choose **More info** → **Run anyway**.
On Linux, the desktop app is an AppImage for
[x86_64](https://github.com/alphaXiv/OpenResearch/releases/latest/download/OpenResearch-x86_64.AppImage)
or [ARM64](https://github.com/alphaXiv/OpenResearch/releases/latest/download/OpenResearch-aarch64.AppImage).
Keep it somewhere you can write to, such as `~/Applications`, so it can update
itself, then change to that directory, run `chmod +x OpenResearch-*.AppImage`, and open it. See
[Linux](docs/linux.md) for requirements.
[Connect a local model](docs/local-models.md) to use LM Studio, oMLX, Ollama,
or a custom endpoint with OpenCode.
Create an account at [openresearch.sh](https://openresearch.sh) to receive email
updates and use managed OpenResearch compute.
## Built for research agents
| | OpenResearch gives you |
|---|---|
| **Parallel exploration** | Give each research direction an independent agent session and isolated git worktree. |
| **Reproducible experiments** | Track variants in a git-native experiment tree; every run receives an immutable archive of its recorded commit. |
| **Evidence in context** | Keep logs, diffs, files, results, and artifacts tied to the work that produced them. |
| **Your choice of agent** | Use Claude Code, Codex, OpenCode, Cursor, or Google Antigravity, with the harness and model selected per session. |
| **Your choice of compute** | Run locally, on your own infrastructure, or with managed OpenResearch compute. |
| **Local ownership** | Keep projects, conversations, experiments, runs, logs, code, and artifacts on your machine. |
### Autoresearch
OpenResearch can run the full loop autonomously: propose an idea, change the
code, launch an experiment, inspect the evidence, and decide what to try next.
Multiple agents can explore different directions in parallel while the
experiment tree preserves their lineage.
## Run anywhere
The same committed source snapshot can run locally, over SSH, or on Slurm,
Kubernetes, Ray, Hugging Face Jobs, Modal, Tinker, and managed OpenResearch compute.
Publishing the repository is not required.
Run the workspace next to remote GPUs while using the browser on your laptop:
```sh
orx up --remote user@host
```
SSH config aliases and custom ports are supported. The remote service binds to
loopback and has no application-level authentication, so other users on that
host can reach it.
## CLI and agent integration
Install the OpenResearch skill into supported coding agents:
```sh
orx install-skills
```
Common commands:
```sh
orx projects
orx project view 
OpenResearch
Claude Code,
Codex,
OpenCode,
Cursor, or Google Antigravity into research agents that can review
literature, develop hypotheses, run experiments, and produce research artifacts.
