CoolFace
Apppublic

FLIRTER/METAHACKATHON

sourceHugging Faceupdated 6mo agoView on Hugging Face
0likes
App README

Vidyarthi Vista OpenEnv Submission

This repository contains an OpenEnv-ready benchmark called Study Coach. It simulates real-world educational planning tasks and provides deterministic grading with dense partial-credit rewards. The baseline inference.py is included and follows the hackathon logging format.

What this environment does

  • —Diagnoses a learner’s weakest topic from analytics.
  • —Builds a time-bounded revision plan aligned to priorities.
  • —Assembles a compact mock-test blueprint with subject/topic/difficulty constraints.

Key files

  • —openenv.yaml — environment metadata for validation and deployment.
  • —Dockerfile — container entrypoint for Hugging Face Spaces.
  • —inference.py — baseline inference script (OpenAI client, HF Router).
  • —my_env_v4/server/app.py — FastAPI server entrypoint.
  • —my_env_v4/server/environment.py — task specs, graders, reward logic.

Tasks & Grading

The environment defines three tasks with deterministic graders:

  1. 1.diagnose_weakness (easy) — single weakest topic + reasoning.
  2. 2.build_revision_plan (medium) — 90‑minute plan with topic order and drill activity.
  3. 3.assemble_mock_blueprint (hard) — 6‑question blueprint with constraints.

Rewards are dense and partial-credit; success thresholds are encoded per task.

Local Run (No Docker)

Start the local server:

powershell
python -m uvicorn my_env_v4.server.app:app --host 127.0.0.1 --port 7860

Run the baseline inference (falls back to deterministic outputs if HF_TOKEN is unset):

powershell
python inference.py

Docker Run

powershell
docker build -t vidyarthi-openenv .
docker run --rm -p 7860:7860 vidyarthi-openenv

Health check:

powershell
Invoke-WebRequest http://127.0.0.1:7860/health

Validation

OpenEnv validator:

powershell
python -m openenv.cli validate .

Submission Checklist

  1. 1.python -m openenv.cli validate . returns OK
  2. 2.docker build -t vidyarthi-openenv . succeeds
  3. 3.docker run --rm -p 7860:7860 vidyarthi-openenv serves /health
  4. 4.python inference.py runs and prints [START], [STEP], [END]
  5. 5.HF_TOKEN is set in your HF Space secrets

Hugging Face Space Notes

See HF_SPACE.md for Space deployment steps and recommended settings.

Environment Variables

See ENV_VARS.md for the full list of required and optional variables.