{"id":48908702,"url":"https://github.com/aojdevstudio/pt-agent","last_synced_at":"2026-04-16T22:03:57.278Z","repository":{"id":291759010,"uuid":"978679983","full_name":"AojdevStudio/pt-agent","owner":"AojdevStudio","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-06T11:06:00.000Z","size":445,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-06T12:28:54.171Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AojdevStudio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-06T10:59:37.000Z","updated_at":"2025-05-06T11:06:03.000Z","dependencies_parsed_at":"2025-05-06T12:39:09.582Z","dependency_job_id":null,"html_url":"https://github.com/AojdevStudio/pt-agent","commit_stats":null,"previous_names":["aojdevstudio/pt-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AojdevStudio/pt-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fpt-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fpt-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fpt-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fpt-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AojdevStudio","download_url":"https://codeload.github.com/AojdevStudio/pt-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fpt-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31905896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"ssl_error","status_checked_at":"2026-04-16T18:21:47.142Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-16T22:03:37.972Z","updated_at":"2026-04-16T22:03:57.268Z","avatar_url":"https://github.com/AojdevStudio.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Personal AI Training Agent\n\n## Overview\n\nThe Personal AI Training Agent is your personalized fitness coach that creates workout plans based on your body's readiness and fitness goals. It uses data from your Oura Ring (if you have one) and adapts your workouts to ensure optimal performance and recovery.\n\n## What It Does\n\n- Creates personalized workout plans that adjust to your body's needs\n- Tracks your progress and keeps you motivated\n- Uses scientific research to inform workout recommendations\n- Integrates with Oura Ring to measure your recovery status\n- Calculates the right weights and intensity for your exercises\n\n## Quick Start Guide\n\n### 1. Set Up Your Environment\n\n```bash\n# Clone the repository\ngit clone https://github.com/AojdevStudio/pt-agent.git\ncd pt-agent\n\n# Create and activate a virtual environment (optional but recommended)\npython -m venv .venv\n# On Windows:\n.venv\\Scripts\\activate\n# On macOS/Linux:\nsource .venv/bin/activate\n\n# Install the package in development mode\nuv pip install -e .\n\n# Set up your configuration\ncp .env.example .env\n# Edit .env with your API keys and settings\n```\n\n### 2. Configure Your Settings\n\nCreate a `.env` file with:\n- `OPENAI_API_KEY`: Your OpenAI API key\n- `OURA_PERSONAL_ACCESS_TOKEN`: Token for accessing Oura Ring data\n- `DATABASE_URL`: Connection string for the database\n\n## Usage\n\nThe Personal AI Training Agent provides a simple CLI interface:\n\n### Plan Commands\n\n```bash\n# View today's workout\nuv run python -m personal_ai_trainer.cli.main p today\n\n# View weekly plan\nuv run python -m personal_ai_trainer.cli.main p week\n\n# View specific day\nuv run python -m personal_ai_trainer.cli.main p day monday\n```\n\n### Log Commands\n\n```bash\n# Log a workout\nuv run python -m personal_ai_trainer.cli.main l workout --notes \"Felt strong today\"\n\n# Log exercises\nuv run python -m personal_ai_trainer.cli.main l exercise --name \"Bench Press\" --sets 3 --reps 8 --weight 150\n\n# View history\nuv run python -m personal_ai_trainer.cli.main l history\n```\n\n### Research Commands\n\n```bash\n# Add research\nuv run python -m personal_ai_trainer.cli.main r add --file path/to/document.pdf\n\n# Search knowledge base\nuv run python -m personal_ai_trainer.cli.main r search \"hypertrophy training\"\n```\n\n### Progress Commands\n\n```bash\n# View stats\nuv run python -m personal_ai_trainer.cli.main pr stats\n\n# View badges\nuv run python -m personal_ai_trainer.cli.main pr badges\n\n# View summary\nuv run python -m personal_ai_trainer.cli.main pr summary\n```\n\n### Profile Commands\n\n```bash\n# Create a new user profile (interactive)\nuv run python -m personal_ai_trainer.cli.main profile create\n\n# List all profiles\nuv run python -m personal_ai_trainer.cli.main profile list\n\n# View an existing profile (uses default if not specified)\nuv run python -m personal_ai_trainer.cli.main profile view [--user-id YOUR_USER_ID]\n\n# Update an existing profile interactively\nuv run python -m personal_ai_trainer.cli.main profile update [--user-id YOUR_USER_ID]\n```\n\nProfile data storage:\n- To enable Supabase storage for profiles, set the following environment variables:\n  ```bash\n  export SUPABASE_URL=your_supabase_url\n  export SUPABASE_KEY=your_supabase_key\n  ```\n- If Supabase is not configured or unavailable, profiles and default user ID are stored locally under `~/.pt-agent/`:\n  - `profiles.json` contains all created profiles.\n  - `config.json` stores the `default_user_id`.\n\nAfter creating a profile with `profile create`, the `user_id` is set as the default, and subsequent plan commands will use it automatically:\n\n```bash\npt p --goal strength\npt p today\n```\n\n## Troubleshooting\n\n- **Commands not working?** Make sure your virtual environment is activated and you've installed the package with `uv pip install -e .`\n- **Missing data?** Check your `.env` file to ensure all API keys are correctly set\n- **Need help?** Run any command with `--help`:\n  ```bash\n  uv run python -m personal_ai_trainer.cli.main --help\n  uv run python -m personal_ai_trainer.cli.main p --help\n  ```\n\nFor more detailed information, see the original documentation or contact support.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faojdevstudio%2Fpt-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faojdevstudio%2Fpt-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faojdevstudio%2Fpt-agent/lists"}