mikamikasuki / forest

# FOREST
**Give it a research question. Turn it into ideas, real experiments, evidence, and a complete paper.**
FOREST is an end-to-end research agent framework for carrying a scientific project from an early question to a finished manuscript.
It can explore and compare research directions, search the literature, turn promising ideas into testable hypotheses, design experiments, run real code on your compute, analyze the results, and decide what to try next. As the project develops, FOREST can revise its plan, abandon weak directions, branch into alternatives, and build the figures, tables, and manuscript around the evidence that survives.
Instead of keeping the research process inside a long chat history, FOREST represents it as an editable research graph. Ideas, hypotheses, experiments, results, decisions, and paper sections remain connected. You can inspect the graph, change a plan, replace a hypothesis, branch from an earlier point, or redirect the research without starting over.
**Idea discovery → literature review → hypothesis formation → experiment design → real execution → result analysis → research-path revision → baselines & ablations → figures & tables → full-paper generation**
## What FOREST does
**Finds research directions.** 
Start with a broad question or an unfinished idea. FOREST explores possible directions, compares them, checks the surrounding literature, and turns the strongest candidates into concrete research paths.
**Turns ideas into experiments.** 
Hypotheses are converted into executable plans with baselines, controls, metrics, ablations, and explicit conditions for success or failure.
**Runs real experiments.** 
FOREST writes and executes research code, launches training and evaluation jobs, collects logs and metrics, and keeps experimental artifacts attached to the research path that produced them.
**Analyzes the evidence and changes course.** 
Results are not treated as the end of a task. FOREST interprets them, compares competing explanations, identifies what failed, and decides whether to extend, revise, or drop a direction.
**Keeps the research path editable.** 
Researchers can intervene at any point: edit a node, change an experiment, revisit an earlier assumption, or branch the graph to investigate an alternative approach without losing the existing work.
**Continues across execution rounds.**
Agents save durable checkpoints at bounded work-round boundaries and automatically continue the same research run. Cumulative turns and planning cycles do not determine scientific lifetime. Recovery uses the retained goal, graph, evidence and action receipts; all rounds and branches share resource accounting. Actual spending, compute limits, permissions and unresolved blockers still govern execution. See research execution and recovery.
**Builds scientific figures and tables.** 
Experimental results can be turned into publication-ready visualizations and tables while remaining tied to their underlying runs and observations.