title: SAT & ACT Learning Lab
emoji: 🧭
colorFrom: indigo
colorTo: yellow
sdk: gradio
sdk_version: 6.24.0
python_version: '3.12'
app_file: app.py
pinned: false
license: other
short_description: Dynamic SAT/ACT practice, mastery, and reasoning graphs
Dearmon Analytics SAT & ACT Learning Lab
Release 1.3.8 provides original dynamic practice for current SAT and
ACT skill blueprints, a four-level topic graph, individual mastery tracking,
targeted practice, and test-like diagnostic sessions. It adds username/password
accounts, secure recovery, an isolated one-click demo, and the embedded teaching
avatar layer used by the Dearmon Analytics Business Calculus platform. Release
1.2.0 introduced deterministic post-miss Break It Apart attribute graphs.
Signed-in students can also download their complete personalized Topic Graph as
a branded PNG, printable PDF, accessible hierarchy-and-concepts CSV, and
verification manifest; demo sessions remain nonexportable.
Release 1.3.8 matches the live Dearmon Analytics palette, typography, DA mark, and compact paper masthead, with the independent-practice disclaimer inside the banner. Its brighter amber-outlined test chooser and Section → Domain → Narrow Topic rails are compressed and closely stacked over translucent ink surfaces with accessible light type. Fresh lessons automatically open Question & Your Work; grading is joined by separate same-lesson and next-lesson actions.
The answer record freezes elapsed time and its blueprint target at grading, then reports their exact reduced fraction and pace comparison. Learner/account and instructor attempt CSVs expose the timing values while legacy untimed rows remain blank. Shared math normalization serves both lesson surfaces and printable exam/answer-key PDFs so raw LaTeX is never the learner-facing fallback. The collapsed item-specific Concepts Needed swim lane, complete analogous worked examples, separate hints, and mastery whitening remain.
The Printable Exam Builder requires an active demo or signed-in learner so every generated file has a cleanup owner. It creates a clean Dearmon Analytics-branded student PDF and a separate answer-key PDF from selected or previously missed topics. Both carry the same random form code. Core scored questions and their answer keys are deterministic. After the active learner has completed every built-in question type for an exact topic, explicit opt-in can create separately labeled, independently reviewed AI supplemental items for printing only. They never decide correctness or alter mastery, readiness, routing, or simulation scores.
After every incorrectly graded practice question, and for every missed objective item reviewed after a completed simulation, Break It Apart constructs a directed acyclic reasoning graph with the tested topic at the top. Sentence items diagram subjects, verbs, direct objects, complements, modifiers, and dependent clauses. Math items build from quantities and units through order of operations and intermediate dependencies. Reading and science items connect claims, evidence, data, variables, and conclusions. The graph is deterministic, makes no model or provider call, and is unavailable before an incorrect grade or completed simulation. Its attributes are explanatory scaffolds, not separate attribute-level mastery or retention records.
Service configuration
This private Space uses the separate Turso database
dearmon-sat-act-learning-lab and schema namespace
sat_act_learning_lab_v1. Its encrypted application uses the versioned Space
secret SAT_ACT_APP_FERNET_V1_3_8_361A7215EF3D_B4E784D7CBC7.
Required Space secrets are OPENAI_API_KEY, TURSO_DATABASE_URL,
TURSO_AUTH_TOKEN, LEARNER_ID_HMAC_SECRET, INSTRUCTOR_EXPORT_SECRET, and
the versioned Fernet secret named above. There is no default instructor
password.
SIMLI_API_KEY is optional and enables learner-initiated live avatar video.
The avatar defaults to the male-professor style, Oliver is selectable, and
Oliver's speech profile uses the cedar voice at speed 1.02. The component is
shown by default, but speech and live video both default off until the learner
opts in. Oliver is an AI-generated teaching persona, not the real person or a
source of real-world claims. The Simli key remains server-side and must never
appear in HTML, browser state, logs, public variables, or /healthz. Text
tutoring remains available when Simli is absent or unavailable.
Username passwords are stored as independently salted scrypt records. Account
lockouts persist in the database, password changes revoke earlier sessions,
and verified legacy name/class/PIN profiles can be converted without moving
their mastery history. Each account receives a one-time-display offline
recovery key that rotates after use. Email one-time-code recovery is optional;
configure AUTH_RECOVERY_EMAIL_ENABLED, AUTH_SMTP_HOST, AUTH_SMTP_PORT,
AUTH_SMTP_USERNAME, AUTH_SMTP_PASSWORD, AUTH_SMTP_FROM_EMAIL,
AUTH_SMTP_STARTTLS, AUTH_SMTP_SSL, and optional
AUTH_SMTP_TIMEOUT_SECONDS; keep provider credentials as Space secrets. Email
codes expire after 15 minutes and are single-use. Without SMTP, offline
recovery remains available.
The one-click demo has a 45-minute ordinary-use window and starts with clearly labeled sample progress. Starting a full simulation reserves its blueprint duration plus a 45-minute completion grace period, capped at four hours. Demo practice and simulation state remain in bounded server memory only: they are not written to Turso, included in instructor analytics or exports, or eligible for account recovery. Sign-out/reset or process restart removes the session immediately; otherwise it disappears at the applicable expiry.
Audio/video are opt-in and audio retention is disabled by default. Deployments serving minors need appropriate notice, consent, provider review, access controls, and retention policies.
Upgrade note
Before replacing any earlier release with v1.3.8, every active timed simulation
must be finished or explicitly abandoned. Saved forms are bound to the app
version and encrypted-source fingerprint, so v1.3.8 intentionally rejects older
checkpoints. Preserve LEARNER_ID_HMAC_SECRET and retain every prior versioned
Fernet secret and rollback commit needed through acceptance testing. The build
still generates its new Fernet key automatically, stores it under
release/private/, and reuses the validated key without prompting.
Independent practice-content notice
This is an independent educational practice product. It is not affiliated with, endorsed by, or sponsored by College Board or ACT, Inc. SAT is a trademark of College Board; ACT is a trademark of ACT, Inc. All practice questions, passages, data, explanations, and figures in this lab are original content. Practice results are diagnostic and are not official scores.