Skip to content

shchukins/human-engine

Human Engine

Русская версия

Train around your life, not around a plan.


Why Human Engine

Most training platforms assume you live for training. You adjust your sleep, your work, your weekends — to fit the plan. Human Engine flips this.

It reads your recovery, looks at your day, and tells you what kind of training makes sense right now — not what the template says.


Your ecosystem, your data

You don't need Garmin to get Garmin-quality load analysis. Human Engine works with whatever you already use — Wahoo, Zwift, Rouvy, Apple Watch, any trainer that exports to Strava. No ecosystem lock-in. No hardware requirements.

Strava and Apple Health are the connectors. Everything else is yours.


What it does

Morning readiness briefing — every morning you get your recovery state, training load trend, and a concrete recommendation for the day. Not a score. An answer.

Adaptive training suggestion — the system knows your calendar, your available time, and your current readiness. It suggests a workout that fits your actual day — duration, intensity, timing.

Explainable outputs — every recommendation shows its reasoning. HRV down, sleep short, high fatigue — you see exactly why. No black box.


How it works

Strava + Apple Health
        ↓
load model + recovery model
        ↓
readiness score + explanation
        ↓
training recommendation
        ↓
morning briefing

The core is deterministic and reproducible. AI is an auxiliary layer, not the product — every output can be traced back to a formula and a data point.


Principles

  • your data stays yours — self-hosted, no third-party cloud
  • deterministic core: same inputs always produce the same outputs
  • explainability over accuracy theatre — know why, not just what
  • ecosystem-agnostic: works with any hardware that talks to Strava or Apple Health

Status

Active prototype. Core pipeline is working end-to-end — readiness is computed daily from real Strava and HealthKit data, delivered to iOS. Product features are in active development.


Documentation

Support

Human Engine is an independent open-source project. Infrastructure and development are self-funded — if you'd like to help, Telegram Stars are welcome.

About

Human Engine is an experimental training analytics platform built around Strava ingestion, FastAPI, PostgreSQL, and self-hosted infrastructure.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors