Skip to content

Repository files navigation

Reasoning Core ◉

Procedural reasoning data for language-model pre-training, post-training, evaluation, and RL.

Reasoning Core generates verifiable textual tasks across first-order logic, symbolic mathematics, planning, algorithms, syntax, and more. Use it as a Python library, generate datasets at scale, or plug it into modern reinforcement-learning environments.

More than 10B tokens of pre-generated data are available in the 🤗 Reasoning Core dataset collection.

Tasks target compact, canonical answers and expose task-native scorers—clean targets for supervised fine-tuning (SFT), with deterministic rewards for RL and evaluation. The public training and influence API provides reproducible paired baseline/treatment experiments. Follow the task influence guide to measure a new or changed task, and compare it with the reference results.

Quickstart

uv pip install "reasoning-core[gen]"   # generate and score
uv pip install reasoning-core          # score only, e.g. as an RL reward over the procedural pile
from reasoning_core import get_task, score_answer

task = get_task("arithmetics")
example = task.generate_example()

print(example.prompt)
assert score_answer(example.answer, example) == 1

Everyday workflows

Python 3.10+. From a checkout, use python -m pip install -e '.[gen]' or bash scripts/install_authoring.sh for lightweight task authoring.

I want to… Start here
Find a task by capability python -m reasoning_core catalog 'graph' --all --json
Generate examples python -m reasoning_core sample arithmetics --count 3 --output /tmp/rc-samples.jsonl
Implement or validate a task Authoring guide
Evaluate a model or score predictions Evaluation recipes
Measure task influence Runnable paired smoke
Propose and implement tasks with agents Task-search guide

Repository layout explains package boundaries and compatibility. Workflow recipes cover prerequisites, commands, output files, and local checks. Catalogue queries read source metadata without importing tasks.

Representative example

function_manipulation combines symbolic operations with short, exact answers:

Prompt

Define h(x) = d/dx (1/x).
Compute h'(1).
The answer is a reduced rational number.

Answer: 2

Browse all 55 task examples.

Task catalogue

GALLERY (names link to gallery examples)

arithmetics · math_word_problem · equation_system · combinatorics_formula · function_manipulation · planar_geometry_relations · metamath_entailment · metamath_core_select · lambda_reduction · rewrite_system · unification_entailment · most_probable_evidence · most_probable_outcome · multistep_nli · defeasible_nli · multistep_evidence_retrieval · multistep_abduction · logic_qa · logic_derivation · planning · set_missing_element · set_expression · sequential_induction · qualitative_reasoning · grid_navigation · reference_tracking · belief_tracking · coreference · constraint_satisfaction · graph_pathfinding · graph_successors · regex_following · regex_reasoning · analogical_case_matching · parsing_derivation · syntax_error_detection · constrained_continuation · table_qa · table_equivalence · table_statistics · string_transduction · game_best_move · game_forced_win · qualitative_causal_reasoning · code_analysis · code_runnability · attribute_grammar · inverse_math · process_inversion · systems_trace · controlled_code_execution · dynamic_programming · rule_switching · shift_reduce_parsing · finite_automaton_execution

Task authoring guidelines

A task authoring guide describes the interface and guidelines.
TASK_AUTHORING_GUIDE TASK_MUTATION_GUIDE TRAINING_AND_INFLUENCE TASK_INFLUENCE

Ecosystem and integrations

  • Prime Intellect — install Reasoning Core from the Environments Hub for evaluation and RL workflows.
  • OpenReward — run Reasoning Core as an OpenReward-compatible environment.
  • OpenEnv — explore the interactive Reasoning Core OpenEnv on Hugging Face Spaces.
  • reasoning-gym — mix Reasoning Core and reasoning-gym tasks through either library's interface.
  • SynLogic — generate SynLogic games through the same task API, backed by SynLogic's native verifiers.

See the integration guide for runnable examples.

Generate datasets at scale

Go from a single example to large pre-training, post-training, and evaluation corpora with balanced difficulty, token budgets, and verifiable answers. The generation pipeline supports parallel workers, resumable jobs, JSONL shards, and postprocessing for Hugging Face Datasets. Start with the sampling and collection recipe.

Citation and paper

@article{sileo2026reasoning,
  title={Reasoning Core: Designing Broad Procedural Data for Completion-Supervised Reasoning Training},
  author={Sileo, Damien and Lacombe, Valentin and Kachler, Dimitri},
  journal={arXiv preprint arXiv:2608.05148},
  year={2026},
  url={https://arxiv.org/abs/2608.05148}
}

https://arxiv.org/abs/2608.05148
Contact: damien.sileo@inria.fr

Releases

Packages

Contributors

Languages