최근 완료된 8시간 회차 사이 GitHub 스타 증가량 순
Use Zwift Click, Zwift Play, Shimano Di2, or any Bluetooth controller with MyWhoosh, Rouvy, Zwift, and more. Free to try on iOS, Android, Windows, and macOS.
개인 계정의 공개 저장소 소유자는 GitHub로 로그인해 운영자를 확인하고 소개를 직접 관리할 수 있습니다. 관리자 승인은 필요하지 않습니다.
로그인한 뒤 확인 파일을 만들어 이 저장소의 기본 브랜치에 30분 안에 커밋해 주세요. 다른 브랜치나 포크의 파일은 인정하지 않습니다. 파일을 올린 뒤 아래에서 확인하면 관리자 승인 없이 관리할 수 있습니다. 자격을 유지하려면 파일을 남겨 두세요.
로그인이 필요하면 로그인 화면으로 이동합니다. 로그인 후 이곳으로 돌아와 원하는 확인 버튼을 다시 눌러 주세요.
프로젝트 폴더에서 /nomorevibe verify를 실행하면 소유권을 확인하고 소개를 직접 관리할 수 있습니다.
1분 만에 확인하기README 전체를 불러오는 중입니다. 아래는 저장된 발췌입니다.
A grounded Fantasy Premier League assistant. Deterministic FPL logic drives all answers; an optional LLM layer polishes the prose. The LLM is subordinate to the backend — it never invents stats.
• Answers captain, transfer, chip, and fixture questions with real FPL data
• Supports multi-turn sessions with pronoun resolution (English + Spanish)
• Exposes a stable HTTP API for stateless and session-based flows
• Optionally wraps answers with Claude or Gemini for natural-language polishREADME 전문 보기 ↗A grounded Fantasy Premier League assistant. Deterministic FPL logic drives all answers; an optional LLM layer polishes the prose. The LLM is subordinate to the backend — it never invents stats.
| Package | Language | Purpose |
|---|---|---|
fpl-grounded-assistant | Python | Core platform — HTTP server, session management, intent routing, LLM integration |
fpl-pipeline | Python | Assembles FPL context: bootstrap + fixtures + FDR in one call |
fpl-tool-runner | Python | ToolRegistry dispatcher for in-process tool execution |
fpl-tool-contract | Python | Defines the 5 structured tools (resolve_player, player_summary, current_gameweek, captain_score, rank_candidates) |
fpl-captain-engine | Python + TS | Captaincy scoring formula (form, xGI/90, fixture difficulty, minutes risk) |
fpl-data-core | Python | Season registry, rolling analytics (xGI/90), position schemas |
fpl-api-client | Python | FPL bootstrap + fixtures HTTP client |
fpl-player-registry | Python | Player identity and nickname resolution (KDB, Salah, etc.) |
fpl-query-tools | Python | Composition layer bridging registry and bootstrap |
fpl-ui | Next.js + TS | Web frontend — Spanish-first slash commands, Patreon-gated |
fpl-charts | TypeScript | Brand color and risk-level theme constants |
football-data-contract | Python | Provider-neutral canonical entities, provenance, and structured evidence contracts |
sportmonks-client | Python | FI-3 Sportmonks transport, provider models, pagination/retry, and offline mocks; no canonical normalization yet |
football-identity-registry | Python | FI-2 deterministic cross-provider identity crosswalk and owned corpus baseline |
football-intelligence | Python | Football feature/module boundary (FI-0(b) scaffold only) |
Backend: Python 3.13, FastAPI, Pydantic v2, Pandas, Anthropic SDK (optional), Google Generativeai (optional)
Frontend: Next.js 15 (App Router), React 19, TypeScript, Tailwind CSS, shadcn/ui
Infrastructure: Docker, Railway (backend), Vercel (frontend)
# Docker
docker build -t fpl-backend:local -f packages/fpl-grounded-assistant/Dockerfile .
docker run --rm -p 8000:8000 \
-e DEFAULT_PROVIDER=anthropic \
-e ANTHROPIC_API_KEY=<key> \
fpl-backend:local
Or with the dev script:
packages/fpl-grounded-assistant/dev-backend.sh
The server exposes /ask (stateless) and /session/* (multi-turn) endpoints.
cd packages/fpl-ui
npm install
npm run dev # http://localhost:3000
The test suite is self-contained — no pytest, no network calls, no API key required:
cd packages/fpl-grounded-assistant
PYTHONPATH=../fpl-tool-runner:../fpl-player-registry:../fpl-captain-engine:\
../fpl-data-core:../fpl-tool-contract:../fpl-query-tools:\
../fpl-api-client:../fpl-pipeline:. python run_phase3d_tests.py
Contract drift gate (run by CI):
bash scripts/run_contract_gate.sh
| File | Contents |
|---|---|
| HANDOFF.md | Full architectural handoff — phases, invariants, public API |
| PROJECT_ROADMAP_SUMMARY.md | Phase history from 0 through V2 |
| FINAL_RESPONSE_CONTRACT.md | Stable respond() / FinalResponse caller contract |
| CONTRACT.md | Adapter layer contract |
| SESSION_CONTRACT.md | Multi-turn session lifecycle |
| PACKAGE_STATUS.md | Status table for all packages |
| orchestrator-instructions.md | Core design principles |