Autonomous research system for measurable, computer-executable research.
Overview
Praxist: meet your personal R&D team Praxist is an autonomous research system for measurable, computer-executable research. It coordinates parallel research peers, task-owned evaluation, durable evidence, and generation-to-generation synthesis. Praxist treats research as a persistent process rather than a sequence of disconnected prompts. Use it when a project already runs and its objective is measurable, but the best path forward is still unknown. Install the complete runtime integrations and finish first-use setup with one command: The local wizard covers the Fair Source License, User Agreement, privacy, runtime profile, masked credentials, Codex skills, writable examples, and readiness checks. It does not select a research project or launch a run. For Claude Code, use the host-specific one-line command. For an agent-managed installation, open Codex: Then ask it to install and configure Praxist using the packaged OOBE runbook, and to stop after readiness checks.
README
Praxist: meet your personal R&D team
Praxist is an autonomous research system for measurable, computer-executable research. It coordinates parallel research peers, task-owned evaluation, durable evidence, and generation-to-generation synthesis.
Praxist treats research as a persistent process rather than a sequence of disconnected prompts. Use it when a project already runs and its objective is measurable, but the best path forward is still unknown.
Install Praxist
Install the complete runtime integrations and finish first-use setup with one command:
python3 -m pip install --index-url https://pypi.org/simple "praxist[agents,codex]" && praxist setup --interactive --install-skills codex
The local wizard covers the Fair Source License, User Agreement, privacy, runtime profile, masked credentials, Codex skills, writable examples, and readiness checks. It does not select a research project or launch a run. For Claude Code, use the host-specific one-line command.
For an agent-managed installation, open Codex:
codex --yolo
Then ask it to install and configure Praxist using the packaged OOBE runbook, and to stop after readiness checks.
Before starting research, read the Quickstart and Your First Task. They describe the separate takeover step and the project contract it creates.
Choose Codex-native mode to use an existing Codex subscription without an API key. For sustained research, Praxist generally favors open-source model APIs with a high observed cache-hit rate. The setup wizard also supports other API-backed profiles.
Use Praxist Through Codex
We recommend Codex as the interface for operating Praxist. Praxist is not a replacement for Codex: Codex remains the interactive agent that understands your project, communicates with you, and uses development tools. Praxist adds the persistent research loop, parallel peers, evidence protocols, scheduling, and lifecycle control.
After installation, open Codex in the root of an already runnable research
project and invoke $praxist-takeover. The takeover skill inspects readiness,
creates or repairs the task harness, validates its evaluator and evidence
contract, and launches the run after the required gates pass. A precise brief
produces a better research plan; include the objective, metrics, constraints,
resources, exploration choices, and whether launch is authorized.
Other bundled skills:
| Skill | Purpose |
|---|---|
praxist-takeover-codex |
No-key takeover using the saved Codex login |
praxist-onboarding |
Explain Praxist and inspect local readiness |
praxist-task-initialization |
Build or repair a task harness without launching |
praxist-interactive-task-init |
Design a task through confirmation-first setup |
praxist-control |
Start, stop, resume, monitor, and inspect runs |
praxist-diagnostic |
Diagnose run health and produce reports |
praxist-scientific-research |
Gather sourced literature and benchmark context |
praxist-runtime-install |
Install or repair runtime dependencies and credentials |
terminal-line-plot |
Draw metric trends in the terminal |
See Agent Skills for invocation syntax and the generated Skills Reference for the complete contracts.
What Praxist Provides
| Capability | Purpose |
|---|---|
| Parallel research peers | Explore competing hypotheses and implementations concurrently |
| Multi-generation synthesis | Carry useful evidence and strategy into later generations |
| Durable evidence lanes | Preserve candidates through incubator, frontier, and Gems state |
| Multi-metric evaluation | Rank task-defined evidence, including Pareto-optimal tradeoffs |
| Quality-Diversity (QD) and optional Deep Innovation Gate (DIG) | Maintain diversity without forcing one exploration policy |
| Central resource scheduling | Adapt experiment admission to observed resource pressure |
| Resume, replay, and monitoring | Keep long-running research inspectable and recoverable |
| Plugin boundaries | Support multiple runtimes, providers, tools, budgets, and workflows |
Praxist And The Task Project
| Praxist owns | The task project owns |
|---|---|
| Research orchestration, lifecycle, evidence protocols, replay, scheduling, and extension interfaces | Research objective, executable code, evaluator, metrics, baselines, prompts, roles, and domain constraints |
Praxist contains no task-specific scientific assumptions. A task remains the single source of truth for what should be tested and what counts as valid evidence.
Operate A Run
praxist status --json
praxist --monitor --latest
praxist stop
praxist resume
Ctrl-C closes only the monitor; it does not stop the research run.
Examples And Templates
praxist examples list
praxist examples install rocket_booster_recovery
praxist examples install rocket_booster_recovery_rust
Complete examples are writable reference projects. templates/tasks/ contains
replaceable scaffolding for building new task harnesses. The two Rocket Booster
Recovery examples demonstrate the same research problem through Python/JAX and
native Rust implementations.
Requirements
| Status | Requirement |
|---|---|
| Required | CPython 3.11+ |
| Required to launch research | A runnable project with measurable evaluation |
| Required for skill-driven operation | Codex or Claude Code; direct CLI operation remains available without either |
| Authentication: choose one | A saved Codex login for Codex-native mode, or a supported provider API key |
| Continuously release-tested | Linux on CPython 3.11 and 3.12 |
| Compatibility target | macOS and other CPython 3.11+ environments; run praxist doctor before research |
Task-specific datasets and compute dependencies remain owned by the task project.
See the platform support matrix for the difference between release-qualified hosts and compatibility targets.
Documentation
Read the Praxist documentation or open it with:
praxist docs
No local documentation server is required.
Contributing To Praxist
Read the contribution guide together with the Code of Conduct before participating. Source maintainers should also follow the architecture and maintenance contract in AGENTS.md. See the Privacy Notice for Praxist’s data-handling terms.
Contact: [email protected]
FAQ
Citation
If you use Praxist in your research, please cite:
@misc{li2026praxistexperimentalartifactssolution,
title={Praxist: From Experimental Artifacts to Solution Lineages},
author={Jin Li and Ahmed Murtadha and Zhiyu Wang and Qiwen Chen and William Chen and Yifei Wu and Guan Wang and Andy L. Siy and Jiayi Yang and Mengsha Huang and Wenhao Li and Yixuan Liu and Shuailin Pan and Mingli Yuan and Sen Song and Yuhao Sun},
year={2026},
eprint={2608.25955},
archivePrefix={arXiv},
primaryClass={cs.MA},
url={https://arxiv.org/abs/2608.25955},
}
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add sapientinc/praxist