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.11.tar.gz (72.8 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.11-py3-none-any.whl (79.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: remyxai-0.4.11.tar.gz
  • Upload date:
  • Size: 72.8 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.11.tar.gz
Algorithm Hash digest
SHA256 9a04cdf71a8e6423a2d1bd5ac5c180d96d03a6388b393e11501e56907ccfa627
MD5 b2ff4c6fbd49887f7ca88dcefba426e7
BLAKE2b-256 b450ef7ff3cda72b13c351f1aaff781d9cacf957c4961e0e5d9bda0ac42d378e

See more details on using hashes here.

Provenance

The following attestation bundles were made for remyxai-0.4.11.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.11-py3-none-any.whl.

File metadata

  • Download URL: remyxai-0.4.11-py3-none-any.whl
  • Upload date:
  • Size: 79.0 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.11-py3-none-any.whl
Algorithm Hash digest
SHA256 4975d80bcdb1e0ccbff806320847ddb49c7f73a8fa34f991de1a2e1da515ef6d
MD5 896f1553196c24a290afe47222c672bb
BLAKE2b-256 3081a458b36d85756accdf7fdb157132d056b9c226d7993e7995f58aef4bd5b0

See more details on using hashes here.

Provenance

The following attestation bundles were made for remyxai-0.4.11-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

0.4.12

2 files

This release

0.4.11 This release

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