activity-generation-model-v1.1

Activity Generation Model v1.1

mjpsm/activity-generation-model-v1.1 is a fine-tuned activity-generation model designed for the MyVillage learning workflow. It generates one small next learning activity from a learner's current context.

The model takes three pieces of context:

• Village goal — the broader learning objective.
• Previous activity title — the activity the learner most recently completed.
• Knowledge submission — what the learner says they learned or still needs help with.

It returns exactly three activity fields:

{
  "title": "string",
  "description": "string",
  "instructions": "string"
}

Version 1.1 was trained to emphasize micro-progression: rather than turning each next activity into a large assignment or multi-step project, it should generate the smallest meaningful next step that builds on demonstrated knowledge.

Model Details

The LoRA adapter was merged back into the base model for the published standalone model. Users therefore do not need PEFT or the original adapter to run this repository.

Intended Use

The model is intended to generate a short next activity after a learner completes an activity and submits a description of what they learned.

A typical flow is:

Village goal
    +
Previous activity title
    +
Knowledge submission
    ↓
activity-generation-model-v1.1
    ↓
Next micro-activity

The model is best suited for learning systems where activities should progress incrementally rather than assigning a large project after every submission.

Improvements Over v1

V1.1 was compared with mjpsm/activity-generation-model-v1 using the same fixed set of 20 benchmark cases, identical prompts, and deterministic decoding.

The strongest measured change is activity simplicity. V1.1 produced single-sentence instructions in 95% of benchmark cases versus 40% for V1 and passed the benchmark's micro-activity heuristic in 90% of cases versus 65%.

V1.1 also preserved 100% valid-JSON and exact-schema compliance while producing substantially shorter outputs.

What the automatic benchmark measures

The micro-activity heuristic checks whether an output:

• uses the exact required schema,
• keeps instructions at or below 30 words,
• uses no more than two instruction sentences,
• avoids detected sequencing language,
• avoids unnecessary setup language, and
• avoids detected large-project language.

The expected-focus diagnostic checks whether an output contains one of the case-specific concepts associated with the learner's stated gap.

These are behavioral diagnostics rather than complete measures of educational quality.

Human evaluation status

A paired human-review sheet was generated for relevance, progression quality, Village-goal alignment, micro-step quality, unsupported assumptions, and clarity. No human scores were entered in the supplied benchmark results, so this model card does not report human-evaluation claims.

Example

Input

Village goal:
Understand how to train, evaluate, and improve machine learning models.

Previous activity title:
Train a Linear Regression Model

Knowledge submission:
I trained a linear regression model and got an R-squared value of 0.7, but I am not sure what that score means for the quality of my model.

Expected output format

{
  "title": "Interpret Your R-Squared Score",
  "description": "Learn what your R-squared score says about your model.",
  "instructions": "Research what R-squared measures and write one sentence explaining what your score means."
}

The exact generated activity can vary. Applications should validate the returned JSON before storing or displaying it.

Running the Model Locally

1. Install dependencies

pip install torch transformers accelerate

torchao is not required.

2. Load and run the model

import json
import torch
from transformers import AutoModelForCausalLM, AutoTokenizer

MODEL_ID = "mjpsm/activity-generation-model-v1.1"

SYSTEM_PROMPT = """You are an educational activity generator for MyVillage.

Given:
1. the Village goal,
2. the previous activity title, and
3. the student's knowledge submission,

generate exactly one small, realistic next learning activity.

The activity must:
- directly build on what the student demonstrated,
- move the student toward the Village goal,
- represent the smallest meaningful next step,
- stay short and focused,
- avoid unnecessary setup,
- avoid large or multi-step projects,
- avoid unsupported named tools, datasets, APIs, people, files, platforms, or requirements,
- allow the same activity title to appear for different students when the same next activity is appropriate.

Return valid JSON only with exactly these fields:
- title
- description
- instructions

Do not include markdown, commentary, activityType, estimatedMinutes, or extra fields.
"""

tokenizer = AutoTokenizer.from_pretrained(MODEL_ID)

dtype = torch.float16 if torch.cuda.is_available() else torch.float32

model = AutoModelForCausalLM.from_pretrained(
    MODEL_ID,
    torch_dtype=dtype,
    device_map="auto" if torch.cuda.is_available() else None,
)

if not torch.cuda.is_available():
    model = model.to("cpu")

model.eval()

village_goal = (
    "Develop foundational 3D modeling skills and learn how to create "
    "detailed objects and environments using professional 3D software."
)

previous_activity_title = "Introduction to Basic 3D Modeling"

knowledge_submission = (
    "I learned how to create basic 3D objects using cubes, spheres, and "
    "cylinders. I still need practice combining shapes into more complex models."
)

user_prompt = f"""Village goal:
{village_goal}

Previous activity title:
{previous_activity_title}

Knowledge submission:
{knowledge_submission}

Generate the next activity."""

messages = [
    {"role": "system", "content": SYSTEM_PROMPT},
    {"role": "user", "content": user_prompt},
]

prompt = tokenizer.apply_chat_template(
    messages,
    tokenize=False,
    add_generation_prompt=True,
)

inputs = tokenizer(
    prompt,
    return_tensors="pt",
).to(model.device)

with torch.inference_mode():
    output = model.generate(
        **inputs,
        max_new_tokens=180,
        do_sample=False,
        repetition_penalty=1.05,
        pad_token_id=tokenizer.eos_token_id,
        eos_token_id=tokenizer.eos_token_id,
    )

generated_tokens = output[0, inputs["input_ids"].shape[1]:]

response = tokenizer.decode(
    generated_tokens,
    skip_special_tokens=True,
).strip()

try:
    activity = json.loads(response)
    print(json.dumps(activity, indent=2))
except json.JSONDecodeError:
    print("Model returned non-JSON output:")
    print(response)

CPU usage

Because the model is based on Qwen2.5-0.5B, it can also be loaded on CPU. CPU inference will generally be slower than GPU inference.

Recommended Inference Behavior

For production use, deterministic or low-temperature generation is recommended because the model is intended to generate concise structured activities.

Applications should:

1. use the same three input fields used during fine-tuning,
2. preserve the instruction to return JSON only,
3. validate that the response contains exactly title, description, and instructions,
4. reject or retry malformed responses, and
5. perform application-level review when activities affect real learners.

Limitations

• The model is small and can still make incorrect assumptions about what activity should come next.
• Concise output does not guarantee correct educational progression.
• The model may introduce a tool, organization, technique, or requirement that was not supported by the learner's submission.
• The model can select an activity that is related to the topic but not the ideal immediate next step.
• Benchmark expected-focus matching is keyword-based and should not be interpreted as semantic understanding.
• The current reported comparison contains only 20 fixed benchmark cases.
• Human educational-quality ratings have not yet been completed.
• The model is designed primarily around the activity-generation patterns represented in its fine-tuning data and may generalize less reliably to substantially different learning environments.

Evaluation Methodology

Both model versions were evaluated with:

• the same 20 fixed cases,
• the same system prompt,
• the same input formatting,
• deterministic decoding (do_sample=False), and
• the same automatic metric implementation.

This controls the inference setup so the comparison focuses on model behavior rather than different prompting strategies.

Latency measurements are included for completeness but are hardware- and runtime-dependent and should not be treated as a universal model-speed benchmark.

Version History

v1.1

• Expanded and redesigned fine-tuning data around micro-progression.
• Generates shorter, more focused next activities.
• Reduces multi-step/sequencing behavior.
• Reduces unnecessary setup instructions.
• Improves expected-focus matching on the fixed benchmark.
• Maintains 100% JSON and schema compliance on the benchmark.

v1

Previous activity-generation model used as the baseline for the V1.1 evaluation.

Disclaimer

This model generates educational activity suggestions. Outputs should be treated as generated recommendations rather than guaranteed pedagogically optimal activities. Systems using the model should validate outputs and apply appropriate human oversight for their learning environment.