Purpose: Lists the Python dependencies for the server.

Dependencies: Key Python dependencies include Flask, Flask-CORS, Pydantic, DataPizza AI, ElevenLabs, and OpenAI.

Key Logic: Lists the Python dependencies for the server.

Notes: None

Purpose: This file is a Flask web application server for a data recommendation system, handling API requests and interactions with various services like OpenAI and ElevenLabs.

Exports: after_request, extract_info, has_none, merge_info, get_question, generate_results, text_to_speech_api, reset

Imports: Flask, request, jsonify, send_file, CORS, io, typing, BaseModel

Key Components:

• after_request (function): A decorator function that adds CORS headers to the response.
• Info (class): A Pydantic model class representing student data, including fields for academic profile, aspiration values, lifestyle preferences, budget, and more.
• Message (class): A Pydantic model class representing a message in the message history for the sidebar, including an ID, text, and sender.

Data Structures: Info, Message

Algorithms: None explicitly defined, but the system uses OpenAI and ElevenLabs APIs for text generation and speech synthesis.

Configuration: The OpenAI and ElevenLabs API keys are set in the code, and the application uses shared memory for persistent data storage.

Notes: The application handles various functionalities such as getting a list of universities, extracting information from text, merging information, generating questions, generating results, and handling speech-to-text API calls.

Purpose: Defines aliases for components and utilities used in the website.

Dependencies: No external dependencies are listed or referenced in this file.

Key Logic: The file does not contain any logic but provides aliases for other files and directories.

Notes: The file is a configuration file and does not contain any logic or functions.

Purpose: Configures ESLint for the project, including rules and extensions.

Dependencies: The file depends on the `@eslint/js`, `globals`, `react-hooks`, and `react-refresh` plugins.

Key Logic: The file configures ESLint to use recommended rules and extensions, including React hooks and TypeScript.

Notes: The file is a configuration file and does not contain any logic or functions.

Purpose: A static HTML file that sets up the basic structure and metadata for the website.

Dependencies: The file depends on the structure and content of the HTML and CSS files.

Key Logic: The file contains the basic structure and metadata for the website, including meta tags, title, and script tags.

Notes: The file is a static HTML file and does not contain any logic or functions.

Purpose: Manages project dependencies and scripts for the Vite React application.

Imports: @radix-ui/react-accordion, @radix-ui/react-alert-dialog, @radix-ui/react-aspect-ratio, @radix-ui/react-avatar, @radix-ui/react-checkbox, @radix-ui/react-collapsible, @radix-ui/react-context-menu, @radix-ui/react-dialog

Dependencies: Key external dependencies and their purpose include React, React Router, and Tailwind CSS.

Key Logic: Manages project dependencies and scripts for the Vite React application.

Notes: Includes scripts for development, build, linting, and preview.

Purpose: Configures PostCSS plugins to be used with Tailwind CSS.

Imports: tailwindcss, autoprefixer

Dependencies: tailwindcss, autoprefixer

Key Logic: Configures PostCSS plugins for Tailwind CSS and autoprefixer.

Notes: No specific notes provided.

Purpose: Styling for the root component of the Vite React application.

Important Classes:

• root
• logo
• card

Dependencies: None

Key Logic: Styling for the root component of the Vite React application.

Notes: Includes media queries for screen readers and animations for the logo.

Purpose: The main entry point for the Vite React application, providing routing and query client context.

Imports: Toaster, Sonner, TooltipProvider, QueryClientProvider, BrowserRouter, Routes, Route, Index

Important Functions:

• App

Dependencies: Key external dependencies and their purpose include React, React Router, and React Query.

Key Logic: Provides routing and query client context for the Vite React application.

Notes: Includes custom routing and query client context.

Purpose: Provides a sidebar component for the website, including a logo, conversation messages, and a scrollable area.

Imports: react, lucide-react, Button, Avatar, AvatarFallback, ScrollArea, pydeiaLogo

Important Functions:

• Sidebar

Dependencies: react, lucide-react, Button, Avatar, AvatarFallback, ScrollArea

Key Logic: Manages the sidebar's layout, including displaying a logo, conversation messages, and handling message scroll events.

Notes: Uses ScrollArea to handle scroll events and ensures messages are scrolled to the bottom.

Purpose: Provides a button component with various styles and behaviors.

Exports: Button, buttonVariants

Imports: React, Slot, cva, cn

Dependencies: React, Slot, cva, cn

Key Logic: Defines a button component with various styles and behaviors using React and class-variance-authority.

Notes: Uses class-variance-authority for CSS class generation and React forwardRef for component ref management.

Purpose: Defines a custom input component with basic styling and behavior.

Exports: Input

Imports: React, InputPrimitive, cn

Important Classes:

• Input

Important Functions:

• React.forwardRef

Dependencies: React and InputPrimitive

Key Logic: Forward ref for React component, applying custom styles and passing props.

Notes: Uses class-variance-authority for dynamic styling and React forwardRef for managing refs.

Purpose: Defines a custom label component using Radix UI's LabelPrimitive and class-variance-authority for styling.

Exports: Label

Imports: React, LabelPrimitive, cvat, cn

Important Classes:

• Label

Important Functions:

• React.forwardRef

Dependencies: Radix UI's LabelPrimitive, class-variance-authority, and React

Key Logic: Forward ref for React component, applying custom styles and passing props.

Notes: Uses class-variance-authority for dynamic styling and React forwardRef for managing refs.

Purpose: Defines a custom popover component using Radix UI's PopoverPrimitive.

Exports: Popover, PopoverTrigger, PopoverContent

Imports: React, PopoverPrimitive, cn

Important Classes:

• Popover
• PopoverTrigger
• PopoverContent

Important Functions:

• React.forwardRef

Dependencies: Radix UI's PopoverPrimitive and React

Key Logic: Forward refs for React components, applying custom styles and passing props.

Notes: Uses class-variance-authority for dynamic styling and React forwardRef for managing refs.

Purpose: Defines a custom select component with basic functionality and styling.

Exports: Select, SelectGroup, SelectValue, SelectTrigger, SelectScrollUpButton, SelectScrollDownButton

Imports: React, SelectPrimitive, cn, Check, ChevronDown, ChevronUp

Important Classes:

• Select
• SelectGroup
• SelectValue
• SelectTrigger
• SelectScrollUpButton

Important Functions:

• React.forwardRef

Dependencies: React, SelectPrimitive, and custom icons

Key Logic: Forward refs for React components, applying custom styles and passing props.

Notes: Uses class-variance-authority for dynamic styling and React forwardRef for managing refs.

Purpose: Defines a custom separator component using Radix UI's SeparatorPrimitive.

Exports: Separator

Imports: React, SeparatorPrimitive, cn

Important Classes:

• Separator

Important Functions:

• React.forwardRef

Dependencies: Radix UI's SeparatorPrimitive and React

Key Logic: Forward ref for React component, applying custom styles and passing props.

Notes: Uses class-variance-authority for dynamic styling and React forwardRef for managing refs.

Purpose: Tailwind CSS configuration and base styles for the Vite React application.

Important Classes:

• :root
• @keyframes logo-spin

Dependencies: None

Key Logic: Tailwind CSS configuration and base styles for the Vite React application.

Notes: Includes tailwind configuration and base styles.

Purpose: The main entry point for the Vite React application.

Imports: createRoot, App

Important Functions:

• createRoot
• App

Dependencies: None

Key Logic: The main entry point for the Vite React application.

Notes: None

Purpose: This file defines the main component for the Index page, which includes state management for messages, conversation state, and speech recognition initialization.

Exports: Index

Imports: useState, useNavigate, ConversationView, EmptyState, Sidebar, useEffect, useRef, Message

Key Components:

• Index (class): The main component for the Index page, managing state for conversation messages, listening status, and speech recognition.
• initializeSpeechRecognition (function): Initializes speech recognition using the SpeechRecognition API and handles the speech recognition events.

Data Structures: Message

Algorithms: Speech recognition using the SpeechRecognition API.

Configuration: State management for conversation messages, listening status, and speech recognition initialization.

Notes: The component uses React hooks for state management and handles speech recognition events to process user input and update the conversation state.

Purpose: Displays university recommendations based on user preferences and profile.

Imports: useNavigate, useLocation, mockRecommendations, mockProsCons, mockWeights

Important Functions:

• Results

Dependencies: useNavigate, useLocation

Key Logic: Fetches and displays university recommendations, handling state from the location.

Notes: Uses location state to fallback to mock data if necessary.

Purpose: Configures Tailwind CSS for the project, including content, theme, and prefixes.

Dependencies: The file depends on the `tailwindcss` library.

Key Logic: The file configures Tailwind CSS to use specific content, theme, and prefixes, allowing for responsive design and styling.

Notes: The file is a configuration file and does not contain any logic or functions.

Purpose: Configures TypeScript options for the project, including compiler options and references.

Dependencies: The file depends on the `@typescript-eslint/parser` and `@typescript-eslint/types` packages.

Key Logic: The file configures TypeScript options for the project, including target version, module resolution, and references to other configuration files.

Notes: The file is a configuration file and does not contain any logic or functions.

Purpose: Configures TypeScript options for the project, including compiler options and references.

Dependencies: The file depends on the `@typescript-eslint/parser` and `@typescript-eslint/types` packages.

Key Logic: The file configures TypeScript options for the project, including noImplicitAny, noUnusedParameters, and skipLibCheck, and references to other configuration files.

Notes: The file is a configuration file and does not contain any logic or functions.

Purpose: Configures TypeScript compiler options for the Node.js environment.

Imports: path, vite

Dependencies: vite

Key Logic: Defines compiler options for TypeScript, including target ES2022, module resolution, and bundler mode.

Notes: Configures Vite to work with TypeScript and Node.js environment.

Purpose: Configures Vite to work with React and sets up server configuration and plugins.

Imports: vite, react, path, componentTagger

Dependencies: vite, react

Key Logic: Sets up Vite server with React support, server configuration, and plugins.

Notes: Includes a custom component tagger for development mode.