Skip to main content

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 init from this shell — ANTHROPIC_API_KEY, ZAI_API_KEY, or MOONSHOT_API_KEY (via gh).

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

remyxai-0.4.12.tar.gz (76.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

remyxai-0.4.12-py3-none-any.whl (82.1 kB view details)

Uploaded Python 3

File details

Details for the file remyxai-0.4.12.tar.gz.

File metadata

  • Download URL: remyxai-0.4.12.tar.gz
  • Upload date:
  • Size: 76.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for remyxai-0.4.12.tar.gz
Algorithm Hash digest
SHA256 dcba7bc1a9c4dc1060a9040dee701226bf5f569d7ca36d88226a9476f2211cdf
MD5 586ceafb19e4c3a9d344109a46d88e83
BLAKE2b-256 2a73753c8c2a1c3770f95f6b003be493733aabf00ed8e405e8cc93d07927d9e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for remyxai-0.4.12.tar.gz:

Publisher: publish.yml on remyxai/remyxai-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file remyxai-0.4.12-py3-none-any.whl.

File metadata

  • Download URL: remyxai-0.4.12-py3-none-any.whl
  • Upload date:
  • Size: 82.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for remyxai-0.4.12-py3-none-any.whl
Algorithm Hash digest
SHA256 3c6aa75f78a71419682144187244968647e8774f5594345c495398d0191a61ee
MD5 46c97d0ab629e278399e6db94f6a4f8c
BLAKE2b-256 6cfaf38ea9f5caefc8f27fc703f4273cc45ac488b82257164ddfb5c463c58389

See more details on using hashes here.

Provenance

The following attestation bundles were made for remyxai-0.4.12-py3-none-any.whl:

Publisher: publish.yml on remyxai/remyxai-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.4.12 This release

2 files

0.4.11

2 files

0.4.10

2 files

0.4.9

2 files

0.4.8

2 files

0.4.7

2 files

0.4.6

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.0

2 files

0.2.7

2 files

0.2.5

2 files

0.2.4

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.8

2 files

0.1.6

1 file

0.1.5

1 file

0.1.4

2 files

0.1.3

2 files

0.1.2.post1

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page