# INERTIA

> INERTIA is an adaptive personal growth and productivity operating system that fuses atomic habit tracking, gamified progression (XP, levels, raid bosses, dual currencies), peer social accountability (Resonances and Kindred clans), psychological/biometric profiling, and Wanderlust AI edge coaching into an integrated daily workflow.

## Overview

INERTIA helps ambitious individuals and high-performance teams remain in motion by eliminating executive friction. By ingesting bio-telemetry and habit data, INERTIA autonomously heals schedules, optimizes routines, and pairs users with compatible accountability pods to foster long-term growth.

- Production Web Application: https://inertia.live
- Wanderlust AI Coaching: https://inertia.live/wanderlust
- Community & Social Hub: https://inertia.live/community
- Edge AI SLM Gateway: https://edge-ai.inertia.live
- API Base Endpoint: https://api.inertia.live/api/v1
- Full Agent Documentation: https://inertia.live/llms-full.txt

## Core Capabilities

- **Wanderlust AI Coaching**: Real-time contextual executive assistant running low-latency small language models (SLMs) at the edge for task triage, schedule negotiation, and motivation.
- **Resonances (Cliques)**: Automated small accountability pods (2-5 peers) generated weekly based on psych compatibility, complementary skills, and goal alignment.
- **Kindred (Clans)**: Persistent guild communities with shared clan levels, cooperative raid bosses, and public leaderboards.
- **Gamified Progression**: Dual-currency economy (Demeres earned from daily habits; Nummus earned from milestones), questlines, XP progression, and cooperative boss encounters.
- **Bio-Telemetry & OpenWearables**: Passive biometrics ingestion (Apple Watch / HealthKit, Oura Ring, Whoop, Garmin, Polar) tracking HRV, sleep architecture, and recovery to adjust daily task loads.
- **Chronos Time Architecture**: 2D/3D temporal visualizers mapping daily cognitive energy against scheduled priorities.

## Key Public Routes

- `/`: Landing page, feature overview, and system manifesto.
- `/wanderlust`: Dedicated deep-focus Wanderlust AI coaching interface with guest session support.
- `/community`: Community hub featuring public challenges, global leaderboards, forums, and governance proposals.
- `/auth`: Secure authentication portal with guest session upgrading.
- `/terms`: Terms of Service.
- `/privacy`: Privacy Policy detailing data sovereignty, biometric isolation, and encryption.

## Domain Glossary

- **Resonances**: Small weekly accountability pods (table: `cliques`) auto-matched for high goal alignment and psychological synergy.
- **Kindred**: Persistent guild communities (table: `groups`) with collective progression and shared challenges.
- **KYN (Know Your Network)**: Opt-in 1-on-1 matchmaking network connecting users with complementary skill profiles.
- **Bonds**: Exclusive dyadic accountability partnerships unlocked at high mutual resonance.
- **Demeres**: Daily operational currency earned through consistent habit execution and task completions.
- **Nummus**: Prestige progression currency earned through major milestone breakthroughs.
- **Wanderlust**: The conversational AI intelligence layer providing adaptive task management and cognitive coaching.

## Architecture

- **Frontend**: React 18 SPA, Vite, Wouter routing, TanStack Query v5, Tailwind CSS, Radix UI, Framer Motion, Cloudflare Pages/Worker CDN.
- **Backend**: Python 3.12, FastAPI, SQLAlchemy ORM, Pydantic v2, PostgreSQL, Redis, Celery / APScheduler.
- **Edge Inference**: Cloudflare Workers AI hosting fine-tuned SLMs (`@cf/meta/llama-3.1-8b-instruct-fp8`) with streaming SSE responses.

For detailed technical specifications and API schemas, see [llms-full.txt](https://inertia.live/llms-full.txt).