researchx 0.0.1

Automated research experiment orchestrator — plan, run, evaluate, iterate.

ResearchX

Experiment 24/7 while you sleep. Research assistant for projects.

⚠️ Alpha Release — ResearchX is in active development. Core loop works, but expect rough edges. Bug reports and feedback welcome: GitHub Issues

Alpha Status

This project is currently alpha and intended for fast iteration.

Known limitations:

• New-experiment loop behavior is still being hardened.
• Abort handling is not yet uniform across every state.
• Autopilot transition audit logging is still being refined.

Install

pipx install researchx
pipx ensurepath          # one-time: adds ~/.local/bin to PATH

Then restart your shell. This works everywhere — bare terminal, conda environments, virtualenvs.

Alternative (if pipx is unavailable):

pip install researchx

Note: pip install places researchx inside your current environment. This may cause dependency conflicts with project packages. Prefer pipx + ensurepath for an isolated install.

Fallback (if researchx command is not on PATH):

python -m researchx .

Troubleshooting

• researchx: command not found after install — Run pipx ensurepath and restart your shell. This adds ~/.local/bin to your PATH so the command is available in all environments, including conda.

Usage

researchx .
researchx /path/to/project
researchx status

What it does NOT do

• Not a paper writing tool — it runs experiments, not LaTeX

---

Built by Sookwan Han · ICCV 2023 Oral · ECCV 2024 Oral · CVPR 2025