How sandeepkr24/forzahelper works
ForzaHelper is a browser-based Forza Horizon 6 car explorer, comparison tool, and conversational Car Finder. The main workflow sends a user’s structured or natural-language filters through the API; chat requests are extracted and validated, interpreted under an explicit tolerance policy, then evaluated by deterministic parameterized queries against PostgreSQL. Results and any labelled alternatives return to the browser. The graph includes documented browse, detail, compare, metadata, and suggestion capabilities. Relationships are cited to the README or source excerpts/index; unsampled implementation details are not inferred.
Main entry points: api.py HTTP API · orchestrator.py Chat turn orchestration · search.py Car search and query builder · models.py Request and response models
Components 13
Browser experience
- Web interface
ui/index.html
API and contracts
- HTTP API
src/forzahelper/api.py - Request and response models
src/forzahelper/models.py - Application settings
src/forzahelper/config.py
Search and interpretation
- Chat turn orchestration
src/forzahelper/chat/orchestrator.py - Filter extraction
src/forzahelper/chat/extraction.py - Tolerance and alternatives
src/forzahelper/interpret.py - Car search and query builder
src/forzahelper/search.py
Data access
- Database connection pool
src/forzahelper/db.py - cars_api view
db/02_cars_api_view.sql
Other components
- Car shopper
- Anthropic model
- PostgreSQL
Connections 18
- Car shopper → Web interface: uses
README.md - Web interface → HTTP API: requests data
README.md - HTTP API → Request and response models: validates
src/forzahelper/api.py - HTTP API → Car search and query builder: routes browse and car operations
src/forzahelper/api.py - HTTP API → Chat turn orchestration: dispatches chat
src/forzahelper/api.py - HTTP API → Application settings: reads settings
src/forzahelper/api.py - Chat turn orchestration → Filter extraction: extracts filters
src/forzahelper/chat/orchestrator.py - Chat turn orchestration → Request and response models: validates filters
src/forzahelper/chat/orchestrator.py - Chat turn orchestration → Tolerance and alternatives: applies policy
src/forzahelper/chat/orchestrator.py - Chat turn orchestration → Car search and query builder: runs search
src/forzahelper/chat/orchestrator.py - Filter extraction → Request and response models: returns filters
src/forzahelper/chat/extraction.py - Filter extraction → Anthropic model: invokes optionally
README.md - Tolerance and alternatives → Car search and query builder: checks alternatives
src/forzahelper/interpret.py - Car search and query builder → Request and response models: builds results
src/forzahelper/search.py - Car search and query builder → Database connection pool: executes queries
src/forzahelper/search.py - Database connection pool → Application settings: configures connections
src/forzahelper/db.py - Database connection pool → PostgreSQL: queries
README.md - PostgreSQL → cars_api view: serves car data
README.md