How mahialaraf/fitz works
This is a terminal movie and TV discovery/advisory app. Users create or load a local profile, then either search for a title or answer preference questions to get recommendations; selected titles receive an AI suitability advisory and can be marked watched. The README only says work is ongoing. The graph follows the sampled Python calls; CSV files are runtime state, and the external AI and TMDB services are evidenced by the source. Other repository files were not inspected.
Main entry points: tools.py Input and state helpers · search_fitz.py Title search and review flow · main.py Menu and profile flow · get_fitz.py Preference scoring
Components 14
Terminal app
- Menu and profile flow
main.py - Input and state helpers
tools.py
Title discovery
- Preference scoring
get_fitz.py - Genre questions and scores
Data.py - Genre-based recommendations
Content_data.py - Title search and review flow
search_fitz.py
AI advisory
- Title correction and advisory
chatbot.py
Local state
- Profile CSV
profiles.csv - Review records CSV
records.csv - Watched titles CSV
marked.csv - Review cache
Data.py
Other components
- User
- TMDB API
- Gemini API
Connections 18
- User → Menu and profile flow: uses
main.py - Menu and profile flow → Input and state helpers: manages profile
main.py - Menu and profile flow → Title search and review flow: starts search
main.py - Menu and profile flow → Preference scoring: starts recommendations
main.py - Menu and profile flow → Input and state helpers: reads and saves profile
main.py - Input and state helpers → Profile CSV: reads and writes
tools.py - Preference scoring → Genre questions and scores: uses questions
get_fitz.py - Preference scoring → Genre-based recommendations: requests titles
get_fitz.py - Preference scoring → Title search and review flow: opens selected title
get_fitz.py - Genre-based recommendations → TMDB API: fetches genres and titles
Content_data.py - Title search and review flow → Title correction and advisory: corrects title and writes advisory
search_fitz.py - Title search and review flow → TMDB API: searches and fetches details
search_fitz.py - Title search and review flow → Input and state helpers: loads and saves reviews
search_fitz.py - Title search and review flow → Input and state helpers: marks watched
search_fitz.py - Title correction and advisory → Gemini API: generates text
chatbot.py - Input and state helpers → Review records CSV: reads and appends
tools.py - Input and state helpers → Watched titles CSV: reads and appends
tools.py - Input and state helpers → Review cache: updates cache
tools.py