freesolo 0.2.56

Environment and dataset helpers for Freesolo-generated repos.

freesolo

freesolo is the published Python SDK surface for generated repos: environments and datasets used for evaluation and task definition.

It is intentionally narrow:

• freesolo.environments
• freesolo.datasets

Everything else (evaluation, tracing, and internal helpers) is kept in the repository for internal workflows but is not part of the public SDK contract.

Install

pip install freesolo

From source:

cd freesolo-sdk
export PYTHONPATH="$PWD/pypi"

Dataset Contract

Dataset records use input and optional output.

{"id": "example-1", "input": "Say yes.", "output": "yes"}

The SDK does not accept aliases such as prompt, query, task, ground_truth, expected_output, or completion.

Environment Contract

Environments are Python modules that expose load_environment() and return an EnvironmentSingleTurn or EnvironmentMultiTurn instance. Environment code uses TaskExample.input and TaskExample.output when building prompts and scoring responses.

Single-turn environments build their initial episode through start_episode(). The SDK prepends the supplied contract text as a system message when the environment did not already provide one, so SFT rows and local evaluation see the same policy prompt. Multi-turn environments own their start_episode() implementation and should include any task-specific initial system message there.

The SDK does not handle remote artifact publishing or resolution.

Example

from freesolo.datasets import load_dataset
from freesolo.environments import load_environment

dataset = load_dataset("support.jsonl")
environment = load_environment("freesolo/environment.py:load_environment")

print(len(dataset.examples))
print(type(environment).__name__)

API Guidance

Use freesolo.datasets for task examples and freesolo.environments for environment loading/scoring interfaces.

• No command-line help surface is published as part of the SDK contract.
• Hidden modules remain available in source history for internal tooling only.