Remyx AI CLI
Install Outrider on a repo, and Remyx handles the loop end-to-end: discovers newly-published arXiv methods matching your team's work, implements them as draft PRs, and validates each against the paper's reference before it lands.
Install
pip install remyxai
export REMYXAI_API_KEY=<your-key> # from engine.remyx.ai/account
Quickstart
Install Outrider on a repo — server-side, no local git touched:
remyxai outrider init --repo your-org/your-repo --auto-interest
By default this installs the two-tier setup: a daily drafter that
explores candidates as fork branches, plus a weekly refiner that promotes
the strongest draft into a ready-for-review PR (crons stay off — drive runs
with remyxai outrider trigger or your own dispatcher). The Remyx GitHub App
authors everything (remyx-ai[bot]).
Model providers
Any provider works, all on equal footing — pick whichever you've connected:
| Provider | --provider value |
Example models |
|---|---|---|
| Claude Code (Anthropic) | anthropic |
claude-opus-4-8 |
| Z.ai | zai |
glm-5.2 |
| Moonshot AI | moonshot |
kimi-k3 |
Unset, each tier follows your connected provider — no vendor is assumed. One provider covers both tiers; tune per tier, or opt out of two-tier entirely:
# Both tiers on one provider (any of the three)
remyxai outrider init --repo your-org/your-repo --auto-interest --provider moonshot
# Mix providers per tier (cheap drafter + capable refiner)
remyxai outrider init --repo your-org/your-repo --auto-interest \
--drafter-provider zai --drafter-model glm-5.2 \
--refiner-provider anthropic
# Plain single-file workflow instead of two-tier
remyxai outrider init --repo your-org/your-repo --auto-interest --single-tier
| Flag | Applies to | Default |
|---|---|---|
--provider / --model |
both tiers | your connected provider / each tier's default |
--drafter-provider / --drafter-model |
daily drafter only | shared provider / tier default |
--refiner-provider / --refiner-model |
weekly refiner only | shared provider / tier default |
--single-tier |
— | off (two-tier is the default) |
--force |
— | off (re-provision a repo that's already installed) |
Provider keys
Every tier needs its provider's API key in the repo, or the first run fails
auth in under a second. init handles both halves:
- every provider you've connected at engine.remyx.ai/integrations is pushed server-side by the engine — one per tier, so mixing providers needs nothing local;
- a tier pointed at a provider you haven't connected is pushed by
initfrom this shell —ANTHROPIC_API_KEY,ZAI_API_KEY, orMOONSHOT_API_KEY(viagh).
A tier with no key either way stops the command before anything is
provisioned; --dry-run reports the same routing. Setting a key on a repo
after the fact:
remyxai outrider set-provider-secret --repo owner/name \
--provider moonshot --key-from ~/moonshot-key
Changing the tier config of a repo that's already installed needs --force —
plain re-runs report "already enabled" and leave the workflow files alone:
remyxai outrider init --repo your-org/your-repo --interest <uuid> \
--refiner-provider moonshot --refiner-model kimi-k3 --force
Trigger a run — three modes of specificity:
# 1. default — Remyx picks from the ranked pool; Outrider's audit augments via agentic search
remyxai outrider trigger --repo your-org/your-repo
# 2. --search-method — override the pool with a free-text query, implement the top hit
remyxai outrider trigger --repo your-org/your-repo \
--search-method "riemannian preconditioning LoRA optimizer"
# 3. --pin-arxiv — exact paper, bypasses selection entirely
remyxai outrider trigger --repo your-org/your-repo --pin-arxiv 2402.02347v3
Refinement runs build on work that already exists — yesterday's drafter branch, or a third party's stalled PR branch — with a written gap analysis as leading context:
remyxai outrider trigger --repo your-org/your-repo \
--start-from-ref outrider/deim-draft \
--lead-content-file gap-analysis.md \
--staged-synthesis --fidelity-policy advisory
--start-from-ref is what the agent builds on; --ref only picks which
branch the workflow file itself comes from. When firing several dispatches at
one repo, add --wait-for-slot: the workflow's concurrency group holds exactly
one pending run, so back-to-back dispatches otherwise cancel each other.
Documentation
| Topic | Doc |
|---|---|
| Pipeline: discovery → implementation → validation | docs/pipeline.md |
| Method-targeted runs + team-scale patterns | docs/method-targeted-runs.md |
| Research Interests: three ways to create one | docs/research-interests.md |
| Install paths, credentials, bulk-install | docs/install-paths.md |
| Full command reference | docs/commands.md |
Development
git clone https://github.com/remyxai/remyxai-cli
cd remyxai-cli
pip install -e .
pytest tests/
Links
- Outrider — the GitHub Action this CLI installs
- engine.remyx.ai — web app, account settings, API key
- Issues — bug reports and feature requests
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file remyxai-0.4.9.tar.gz.
File metadata
- Download URL: remyxai-0.4.9.tar.gz
- Upload date:
- Size: 70.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3e2c8c76448d28adfdad9f9570018f6d1bb76f206d3136ab264c54c5f03de5ac
|
|
| MD5 |
fdae65a3e92bf4a45b23b0e03726905f
|
|
| BLAKE2b-256 |
e4ecdc5b8081b48bd25fafd0deb13e8bab67cbeec974462ce7c7889de92ae42f
|
Provenance
The following attestation bundles were made for remyxai-0.4.9.tar.gz:
Publisher:
publish.yml on remyxai/remyxai-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
remyxai-0.4.9.tar.gz -
Subject digest:
3e2c8c76448d28adfdad9f9570018f6d1bb76f206d3136ab264c54c5f03de5ac - Sigstore transparency entry: 2446936281
- Sigstore integration time:
-
Permalink:
remyxai/remyxai-cli@7ebf83796eec92d7c5ac20792fabab50b59d969c -
Branch / Tag:
refs/tags/v0.4.9 - Owner: https://github.com/remyxai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@7ebf83796eec92d7c5ac20792fabab50b59d969c -
Trigger Event:
release
-
Statement type:
File details
Details for the file remyxai-0.4.9-py3-none-any.whl.
File metadata
- Download URL: remyxai-0.4.9-py3-none-any.whl
- Upload date:
- Size: 76.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3adcf54720f71cf0ac97785d59d18e6ef827fe1f62c77d484389597dbcc9bc42
|
|
| MD5 |
7e9712e0ce5df9b3c60a04706e0b16e7
|
|
| BLAKE2b-256 |
2bddd930588b339c1b68e01d778b617abf2d884fc7de1a7ba95d7eef2fbb4eca
|
Provenance
The following attestation bundles were made for remyxai-0.4.9-py3-none-any.whl:
Publisher:
publish.yml on remyxai/remyxai-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
remyxai-0.4.9-py3-none-any.whl -
Subject digest:
3adcf54720f71cf0ac97785d59d18e6ef827fe1f62c77d484389597dbcc9bc42 - Sigstore transparency entry: 2446936422
- Sigstore integration time:
-
Permalink:
remyxai/remyxai-cli@7ebf83796eec92d7c5ac20792fabab50b59d969c -
Branch / Tag:
refs/tags/v0.4.9 - Owner: https://github.com/remyxai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@7ebf83796eec92d7c5ac20792fabab50b59d969c -
Trigger Event:
release
-
Statement type: