MathAssistant / app.py
jujutechnology's picture
Update app.py
f7c0039 verified
raw
history blame
35.2 kB
import streamlit as st
import google.generativeai as genai
import os
import json
import base64
from dotenv import load_dotenv
from streamlit_local_storage import LocalStorage
import re
import streamlit.components.v1 as components
import math # Needed for trigonometry in dynamic visuals
# --- PAGE CONFIGURATION ---
st.set_page_config(
page_title="Math Jegna - Your AI Math Tutor",
page_icon="๐Ÿง ",
layout="wide"
)
# Create an instance of the LocalStorage class
localS = LocalStorage()
# --- HELPER FUNCTIONS ---
def format_chat_for_download(chat_history):
"""Formats the chat history into a human-readable string for download."""
# (Code remains the same)
formatted_text = f"# Math Mentor Chat\n\n"
for message in chat_history:
role = "You" if message["role"] == "user" else "Math Mentor"
formatted_text += f"**{role}:**\n{message['content']}\n\n---\n\n"
return formatted_text
def convert_role_for_gemini(role):
"""Convert Streamlit chat roles to Gemini API roles"""
# (Code remains the same)
if role == "assistant":
return "model"
return role
def should_generate_visual(user_prompt, ai_response):
"""Determine if a visual aid would be helpful based on the content"""
# (Code remains the same)
k12_visual_keywords = [
'add', 'subtract', 'multiply', 'times', 'divide', 'divided by', 'counting', 'numbers',
'fraction', 'half', 'quarter', 'third', 'parts', 'whole',
'shape', 'triangle', 'circle', 'square', 'rectangle',
'money', 'coins', 'dollars', 'cents', 'change',
'time', 'clock', 'hours', 'minutes', 'o\'clock',
'measurement', 'length', 'height', 'weight',
'place value', 'tens', 'ones', 'hundreds',
'pattern', 'sequence', 'skip counting',
'greater than', 'less than', 'equal', 'compare',
'number line', 'array', 'grid', 'area model'
]
combined_text = (user_prompt + " " + ai_response).lower()
return any(keyword in combined_text for keyword in k12_visual_keywords) or any(op in user_prompt for op in ['*', '/'])
def create_visual_manipulative(user_prompt, ai_response):
"""-- SMART VISUAL ROUTER (UPGRADED) --"""
try:
user_lower = user_prompt.lower().replace(' ', '')
# Priority 1: Division
div_match = re.search(r'(\d+)dividedby(\d+)', user_lower) or re.search(r'(\d+)/(\d+)', user_lower)
if div_match and "fraction" not in user_lower:
dividend, divisor = int(div_match.group(1)), int(div_match.group(2))
if dividend <= 50 and divisor > 0:
return create_division_groups_visual(dividend, divisor)
# Priority 2: Multiplication (UPGRADED LOGIC)
mult_match = re.search(r'(\d+)(?:x|times|\*)(\d+)', user_lower)
if mult_match:
num1, num2 = int(mult_match.group(1)), int(mult_match.group(2))
# NEW: Use multi-model visual for basic facts
if num1 <= 10 and num2 <= 10:
return create_multi_model_multiplication_visual(num1, num2)
# Use fixed area model for larger numbers
elif 10 < num1 < 100 and 10 < num2 < 100:
return create_multiplication_area_model(num1, num2)
# Other priorities remain the same...
time_match = re.search(r'(\d{1,2}):(\d{2})', user_lower) or re.search(r'(\d{1,2})o\'clock', user_lower)
if time_match:
groups = time_match.groups()
hour = int(groups[0])
minute = int(groups[1]) if len(groups) > 1 and groups[1] else 0
if 1 <= hour <= 12 and 0 <= minute <= 59: return create_clock_visual(hour, minute)
fraction_match = re.search(r'(\d+)/(\d+)', user_lower)
if fraction_match:
num, den = int(fraction_match.group(1)), int(fraction_match.group(2))
if 0 < num <= den and den <= 16: return create_dynamic_fraction_circle(num, den)
if any(word in user_lower for word in ['add', 'plus', '+', 'subtract', 'minus', 'takeaway', '-']):
numbers = re.findall(r'\d+', user_prompt)
if len(numbers) >= 2:
num1, num2 = int(numbers[0]), int(numbers[1])
operation = 'add' if any(w in user_lower for w in ['add', 'plus', '+']) else 'subtract'
if num1 <= 20 and num2 <= 20: return create_counting_blocks(num1, num2, operation)
if 'numberline' in user_lower:
numbers = [int(n) for n in re.findall(r'\d+', user_prompt)]
if numbers: return create_number_line(min(numbers) - 2, max(numbers) + 2, numbers, "Your Numbers on the Line")
if 'placevalue' in user_lower:
numbers = re.findall(r'\d+', user_prompt)
if numbers and int(numbers[0]) <= 999: return create_place_value_blocks(int(numbers[0]))
# Fallbacks remain the same
if any(word in user_lower for word in ['fraction', 'part']): return create_dynamic_fraction_circle(1, 2)
if any(word in user_lower for word in ['shape']): return create_shape_explorer()
if any(word in user_lower for word in ['money', 'coin']): return create_money_counter()
if any(word in user_lower for word in ['time', 'clock']): return create_clock_visual(10, 10)
return None
except Exception as e:
st.error(f"Could not create visual: {e}")
return None
# --- VISUAL TOOLBOX FUNCTIONS ---
def create_multi_model_multiplication_visual(rows, cols):
"""(BRAND NEW) Creates a rich, multi-model view for basic multiplication facts."""
# 1. Equal Groups visual
groups_html = ""
for r in range(rows):
dots = "".join([f'<div style="width:12px; height:12px; background:#FF6B6B; border-radius:50%;"></div>' for _ in range(cols)])
groups_html += f'<div style="border:2px solid #FFADAD; border-radius:8px; padding:5px; display:flex; flex-wrap:wrap; gap:4px; justify-content:center; margin:2px;">{dots}</div>'
# 2. Array visual (SVG)
cell_size, gap = 20, 4
svg_width = cols * (cell_size + gap)
svg_height = rows * (cell_size + gap)
array_dots = "".join([f'<circle cx="{c*(cell_size+gap)+cell_size/2}" cy="{r*(cell_size+gap)+cell_size/2}" r="{cell_size/2-2}" fill="#4ECDC4"/>' for r in range(rows) for c in range(cols)])
array_svg = f'<svg width="{svg_width}" height="{svg_height}" style="margin: 0 auto;">{array_dots}</svg>'
# 3. Repeated Addition
addition_str = " + ".join([str(cols) for _ in range(rows)])
# 4. Number Line (SVG)
line_end = rows * cols + 2
line_width = 400
padding = 20
scale = (line_width - 2 * padding) / line_end
ticks = "".join([f'<text x="{padding + i*scale}" y="35" text-anchor="middle" font-size="10">{i}</text>' for i in range(0, line_end, 2)])
jumps_html = ""
for i in range(rows):
start_x, end_x = padding + (i * cols * scale), padding + ((i + 1) * cols * scale)
jumps_html += f'<path d="M {start_x} 20 Q {(start_x+end_x)/2} -5, {end_x} 20" stroke="#FFD93D" fill="none" stroke-width="2"/>'
number_line_svg = f'<svg width="{line_width}" height="40"><line x1="{padding}" y1="20" x2="{line_width-padding}" y2="20" stroke="#333"/>{ticks}{jumps_html}</svg>'
html = f"""
<div style="font-family: sans-serif; padding: 20px; background: #f8f9fa; border: 1px solid #dee2e6; border-radius: 15px; margin: 10px 0;">
<h3 style="text-align: center; color: #333; margin-bottom:25px;">Four Ways to See {rows} ร— {cols} = {rows*cols}</h3>
<div style="display: grid; grid-template-columns: 1fr 1fr; gap: 20px;">
<div style="border: 1px solid #ddd; padding: 10px; border-radius: 8px;">
<h4 style="text-align:center; margin-top:0;">Use an Array</h4>{array_svg}
</div>
<div style="border: 1px solid #ddd; padding: 10px; border-radius: 8px;">
<h4 style="text-align:center; margin-top:0;">Use Equal Groups</h4><div style="display:flex; flex-wrap:wrap; gap:5px; justify-content:center;">{groups_html}</div>
</div>
<div style="border: 1px solid #ddd; padding: 10px; border-radius: 8px;">
<h4 style="text-align:center; margin-top:0;">Use Repeated Addition</h4><div style="text-align:center; font-size: 1.5em; color: #0077b6;">{addition_str}</div>
</div>
<div style="border: 1px solid #ddd; padding: 10px; border-radius: 8px;">
<h4 style="text-align:center; margin-top:0;">Use a Number Line</h4>{number_line_svg}
</div>
</div>
</div>
"""
return html
def create_multiplication_area_model(num1, num2):
"""(FIXED & Dynamic) Creates a correctly formatted area model for 2-digit multiplication."""
n1_tens, n1_ones = num1 // 10, num1 % 10
n2_tens, n2_ones = num2 // 10, num2 % 10
p1, p2, p3, p4 = n1_tens*10 * n2_tens*10, n1_tens*10 * n2_ones, n1_ones * n2_tens*10, n1_ones * n2_ones
total = p1 + p2 + p3 + p4
html = f"""
<div style="font-family: sans-serif; padding: 20px; background: #f0f8ff; border-radius: 15px; margin: 10px 0;">
<h3 style="text-align: center; color: #333;">Area Model for {num1} ร— {num2}</h3>
<div style="display: flex; justify-content: center; align-items: center; margin-top: 20px;">
<!-- Row Headers -->
<div style="display: flex; flex-direction: column; text-align: right; gap: 5px; margin-right: 5px;">
<div style="height: 60px; display: flex; align-items: center; justify-content: flex-end; font-weight: bold; color: #0077b6;">{n1_tens*10}</div>
<div style="height: 60px; display: flex; align-items: center; justify-content: flex-end; font-weight: bold; color: #0077b6;">{n1_ones}</div>
</div>
<!-- Grid -->
<div style="display: inline-grid; border: 2px solid #333;">
<!-- Column Headers -->
<div style="display: flex; grid-column: 1 / 3;">
<div style="width: 100px; text-align: center; font-weight: bold; color: #d00000; padding: 5px;">{n2_tens*10}</div>
<div style="width: 100px; text-align: center; font-weight: bold; color: #d00000; padding: 5px;">{n2_ones}</div>
</div>
<!-- Row 1 -->
<div style="grid-row: 2; width: 100px; height: 60px; background: #FFADAD; text-align: center; border: 1px solid #333; padding: 5px;">{p1}</div>
<div style="grid-row: 2; width: 100px; height: 60px; background: #FFD6A5; text-align: center; border: 1px solid #333; padding: 5px;">{p2}</div>
<!-- Row 2 -->
<div style="grid-row: 3; width: 100px; height: 60px; background: #FDFFB6; text-align: center; border: 1px solid #333; padding: 5px;">{p3}</div>
<div style="grid-row: 3; width: 100px; height: 60px; background: #CAFFBF; text-align: center; border: 1px solid #333; padding: 5px;">{p4}</div>
</div>
</div>
<div style="text-align: center; margin-top: 20px; font-size: 1.2em;">
<b>Add the partial products:</b> {p1} + {p2} + {p3} + {p4} = <b>{total}</b>
</div>
</div>
"""
return html
# --- [All other visual functions and app code remain the same] ---
# Note: For brevity, only the changed and new functions are shown in full detail.
# The rest of the functions (division, counting, fractions, etc.) are included below.
def create_division_groups_visual(dividend, divisor):
"""(Dynamic) Creates a visual for division by grouping."""
if divisor == 0: return ""
quotient = dividend // divisor
groups_html = ""
dot_colors = ["#FF6B6B", "#4ECDC4", "#FFD93D", "#95E1D3", "#A0C4FF", "#FDBF6F"]
for i in range(divisor):
dots_in_group = "".join([f'<div style="width: 15px; height: 15px; background: {dot_colors[i % len(dot_colors)]}; border-radius: 50%;"></div>' for _ in range(quotient)])
groups_html += f'<div style="border: 2px dashed {dot_colors[i % len(dot_colors)]}; border-radius: 10px; padding: 10px; text-align: center;"><b style="color: #333;">Group {i+1}</b><div style="display: flex; flex-wrap: wrap; gap: 5px; margin-top: 10px; justify-content: center;">{dots_in_group}</div></div>'
html = f"""<div style="padding: 20px; background: #f0f2f6; border-radius: 15px; margin: 10px 0;"><h3 style="text-align: center; color: #333;">Dividing {dividend} into {divisor} Groups</h3><p style="text-align: center; color: #555;">We are sharing {dividend} items equally among {divisor} groups.</p><div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(120px, 1fr)); gap: 15px; margin-top: 20px;">{groups_html}</div><h4 style="text-align: center; margin-top: 25px; color: #333;">Each group gets <b>{quotient}</b> items. So, {dividend} รท {divisor} = {quotient}.</h4></div>"""
return html
def create_counting_blocks(num1, num2, operation):
"""(Dynamic) Create colorful counting blocks for addition/subtraction."""
html = f"""<div style="padding: 20px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 15px; margin: 10px 0;"><h3 style="color: white; text-align: center; margin-bottom: 20px;">๐Ÿงฎ Counting Blocks: {num1} {'+' if operation == 'add' else 'โˆ’'} {num2}</h3><div style="display: flex; justify-content: center; align-items: center; gap: 20px; flex-wrap: wrap;"><div style="display: flex; flex-wrap: wrap; gap: 5px; border: 2px dashed #FFE066; padding: 5px; border-radius: 5px; align-items: center; justify-content: center; min-width: 100px;"><div style="width: 100%; text-align:center; color: white; font-weight: bold;">{num1}</div>{''.join([f'<div style="width: 25px; height: 25px; background: #FF6B6B; border-radius: 5px;"></div>' for _ in range(num1)])}</div><div style="font-size: 40px; color: #FFE066;">{'+' if operation == 'add' else 'โˆ’'}</div><div style="display: flex; flex-wrap: wrap; gap: 5px; border: 2px dashed #FFE066; padding: 5px; border-radius: 5px; align-items: center; justify-content: center; min-width: 100px;"><div style="width: 100%; text-align:center; color: white; font-weight: bold;">{num2}</div>{''.join([f'<div style="width: 25px; height: 25px; background: #4ECDC4; border-radius: 5px;"></div>' for _ in range(num2)])}</div><div style="font-size: 40px; color: #FFE066;">=</div><div style="display: flex; flex-wrap: wrap; gap: 5px; border: 2px solid white; background: rgba(255,255,255,0.2); padding: 5px; border-radius: 5px; align-items: center; justify-content: center; min-width: 100px;"><div style="width: 100%; text-align:center; color: white; font-weight: bold;">{num1 + num2 if operation == 'add' else max(0, num1 - num2)}</div>{''.join([f'<div style="width: 25px; height: 25px; background: #95E1D3; border-radius: 5px;"></div>' for _ in range(num1 + num2 if operation == 'add' else max(0, num1 - num2))])}</div></div></div>"""
return html
def create_dynamic_fraction_circle(numerator, denominator):
"""(Dynamic) Generates an SVG of a pizza/pie to represent a fraction."""
if not (0 < numerator <= denominator): return "<p>I can only show proper fractions!</p>"
width, height, radius = 150, 150, 60
cx, cy = width / 2, height / 2
slices_html = ''
angle_step = 360 / denominator
for i in range(denominator):
start_angle, end_angle = i * angle_step, (i + 1) * angle_step
fill_color = "#FF6B6B" if i < numerator else "#DDDDDD"
start_rad, end_rad = math.radians(start_angle - 90), math.radians(end_angle - 90)
x1, y1 = cx + radius * math.cos(start_rad), cy + radius * math.sin(start_rad)
x2, y2 = cx + radius * math.cos(end_rad), cy + radius * math.sin(end_rad)
large_arc_flag = 1 if angle_step > 180 else 0
path_d = f"M {cx},{cy} L {x1},{y1} A {radius},{radius} 0 {large_arc_flag},1 {x2},{y2} Z"
slices_html += f'<path d="{path_d}" fill="{fill_color}" stroke="#333" stroke-width="2"/>'
html = f"""<div style="padding: 20px; background: linear-gradient(135deg, #A8EDEA 0%, #FED6E3 100%); border-radius: 15px; margin: 10px 0;"><h3 style="color: #333; text-align: center;">Fraction Pizza: {numerator}/{denominator}</h3><div style="display: flex; justify-content: center;"><svg width="{width}" height="{height}">{slices_html}</svg></div><p style="color: #333; text-align: center; margin-top: 15px; font-size: 18px;">The pizza is cut into <b>{denominator}</b> equal slices, and we are showing <b>{numerator}</b> of them! ๐Ÿ•</p></div>"""
return html
def create_clock_visual(hours, minutes):
"""(Dynamic) Create a clock showing a specific time."""
min_angle = minutes * 6
hour_angle = (hours % 12 + minutes / 60) * 30
html = f"""<div style="padding: 20px; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 15px; margin: 10px 0;"><h3 style="color: white; text-align: center; margin-bottom: 20px;">๐Ÿ• Learning Time!</h3><div style="display: flex; justify-content: center;"><svg width="250" height="250" viewBox="0 0 250 250" style="background: white; border-radius: 50%; border: 8px solid #FFE066;"><circle cx="125" cy="125" r="110" fill="white" stroke="#333" stroke-width="2"/><text x="125" y="45" text-anchor="middle" font-size="20" font-weight="bold" fill="#333">12</text><text x="205" y="130" text-anchor="middle" font-size="20" font-weight="bold" fill="#333">3</text><text x="125" y="215" text-anchor="middle" font-size="20" font-weight="bold" fill="#333">6</text><text x="45" y="130" text-anchor="middle" font-size="20" font-weight="bold" fill="#333">9</text><line x1="125" y1="125" x2="125" y2="40" stroke="#FF6B6B" stroke-width="6" stroke-linecap="round" transform="rotate({hour_angle}, 125, 125)"/><line x1="125" y1="125" x2="125" y2="25" stroke="#4ECDC4" stroke-width="4" stroke-linecap="round" transform="rotate({min_angle}, 125, 125)"/><circle cx="125" cy="125" r="8" fill="#333"/></svg></div><div style="text-align: center; margin-top: 20px;"><p style="color: #FFE066; font-size: 24px; font-weight: bold;">This clock shows {hours:02d}:{minutes:02d}</p><p style="color: white; font-size: 16px;">The short <span style="color:#FF6B6B">red</span> hand points to the hour. The long <span style="color:#4ECDC4">blue</span> hand points to the minutes.</p></div></div>"""
return html
def create_number_line(start, end, points, title="Number Line"):
"""(Dynamic) Creates a simple number line SVG."""
width = 600
padding = 30
if start >= end: end = start + 1
scale = (width - 2 * padding) / (end - start)
def to_x(n): return padding + (n - start) * scale
ticks_html = "".join([f'<g transform="translate({to_x(i)}, 50)"><line y2="10" stroke="#aaa"/><text y="30" text-anchor="middle" fill="#555">{i}</text></g>' for i in range(start, end + 1)])
points_html = "".join([f'<g transform="translate({to_x(p)}, 50)"><circle r="8" fill="#FF6B6B" stroke="white" stroke-width="2"/><text y="-15" text-anchor="middle" font-weight="bold" fill="#D63031">{p}</text></g>' for p in points])
html = f"""<div style="padding: 20px; background: #f7f1e3; border-radius: 15px; margin: 10px 0;"><h3 style="text-align: center; color: #333;">{title}</h3><svg width="{width}" height="100"><line x1="{padding}" y1="50" x2="{width-padding}" y2="50" stroke="#333" stroke-width="2"/>{ticks_html}{points_html}</svg></div>"""
return html
def create_place_value_blocks(number):
"""(Dynamic) Create place value blocks for understanding numbers."""
hundreds, tens, ones = number // 100, (number % 100) // 10, number % 10
h_block_html, t_block_html, o_block_html = "", "", ""
if hundreds > 0:
hundreds_grid = "".join(["<div style='background:#F5A6A6'></div>"] * 100)
hundreds_squares = "".join([f'<div style="width: 100px; height: 100px; background: #FF6B6B; border: 2px solid #D63031; display: grid; grid-template-columns: repeat(10, 1fr); gap: 2px; padding: 2px;">{hundreds_grid}</div>' for _ in range(hundreds)])
h_block_html = f'<div style="text-align: center;"><h4>Hundreds: {hundreds}</h4><div style="display: flex; gap: 5px;">{hundreds_squares}</div></div>'
if tens > 0:
tens_grid = "".join(["<div style='background:#A2E8E4'></div>"] * 10)
tens_sticks = "".join([f'<div style="width: 10px; height: 100px; background: #4ECDC4; border: 2px solid #00B894; display: grid; grid-template-rows: repeat(10, 1fr); gap: 2px; padding: 2px;">{tens_grid}</div>' for _ in range(tens)])
t_block_html = f'<div style="text-align: center;"><h4>Tens: {tens}</h4><div style="display: flex; gap: 5px; align-items: flex-end;">{tens_sticks}</div></div>'
if ones > 0:
ones_cubes = "".join(['<div style="width: 10px; height: 10px; background: #FFE066; border: 2px solid #FDCB6E;"></div>' for _ in range(ones)])
o_block_html = f'<div style="text-align: center;"><h4>Ones: {ones}</h4><div style="display: flex; gap: 5px; align-items: flex-end; flex-wrap: wrap; width: 50px; justify-content: center;">{ones_cubes}</div></div>'
html = f"""<div style="padding: 20px; background: linear-gradient(135deg, #dfe6e9 0%, #b2bec3 100%); border-radius: 15px; margin: 10px 0;"><h3 style="color: #333; text-align: center;">Place Value Blocks for {number}</h3><div style="display: flex; justify-content: center; align-items: flex-end; gap: 20px; flex-wrap: wrap; padding: 20px 0; min-height: 150px;">{h_block_html}{t_block_html}{o_block_html}</div><div style="text-align: center; margin-top: 15px; padding: 10px; background: rgba(0,0,0,0.1); border-radius: 10px;"><h4 style="color: #333; margin:0;">{hundreds} Hundreds + {tens} Tens + {ones} Ones = {number}</h4></div></div>"""
return html
def create_shape_explorer():
"""(Static) Create colorful shape recognition tool."""
html = """<div style="padding: 20px; background: linear-gradient(135deg, #A8EDEA 0%, #FED6E3 100%); border-radius: 15px; margin: 10px 0;"><h3 style="color: #333; text-align: center; margin-bottom: 20px;">๐Ÿ”ท Shape Explorer!</h3><div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 20px; max-width: 600px; margin: 0 auto;"><div style="text-align: center; padding: 15px; background: white; border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"><h4 style="color: #333; margin-bottom: 10px;">Circle</h4><svg width="80" height="80"><circle cx="40" cy="40" r="35" fill="#FF6B6B" stroke="#333" stroke-width="3"/></svg><p style="color: #666; font-size: 12px; margin-top: 10px;">Round and smooth!</p></div><div style="text-align: center; padding: 15px; background: white; border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"><h4 style="color: #333; margin-bottom: 10px;">Square</h4><svg width="80" height="80"><rect x="12.5" y="12.5" width="55" height="55" fill="#4ECDC4" stroke="#333" stroke-width="3"/></svg><p style="color: #666; font-size: 12px; margin-top: 10px;">4 equal sides!</p></div><div style="text-align: center; padding: 15px; background: white; border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"><h4 style="color: #333; margin-bottom: 10px;">Triangle</h4><svg width="80" height="80"><polygon points="40,15 15,65 65,65" fill="#FFD93D" stroke="#333" stroke-width="3"/></svg><p style="color: #666; font-size: 12px; margin-top: 10px;">3 sides and corners!</p></div><div style="text-align: center; padding: 15px; background: white; border-radius: 10px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);"><h4 style="color: #333; margin-bottom: 10px;">Rectangle</h4><svg width="80" height="80"><rect x="10" y="25" width="60" height="30" fill="#95E1D3" stroke="#333" stroke-width="3"/></svg><p style="color: #666; font-size: 12px; margin-top: 10px;">4 sides, opposite sides equal!</p></div></div><p style="color: #333; text-align: center; margin-top: 20px; font-size: 18px;">Can you find these shapes around you? ๐Ÿ”โœจ</p></div>"""
return html
def create_money_counter():
"""(Static) Create coin counting visual."""
html = """<div style="padding: 20px; background: linear-gradient(135deg, #FFE259 0%, #FFA751 100%); border-radius: 15px; margin: 10px 0;"><h3 style="color: #333; text-align: center; margin-bottom: 20px;">๐Ÿ’ฐ Money Counter!</h3><div style="display: flex; justify-content: center; gap: 30px; flex-wrap: wrap;"><div style="text-align: center; padding: 15px; background: white; border-radius: 10px;"><h4 style="color: #333;">Penny</h4><div style="width: 50px; height: 50px; background: #CD7F32; border-radius: 50%; margin: 10px auto; display: flex; align-items: center; justify-content: center; border: 3px solid #8B4513;"><span style="color: white; font-weight: bold;">1ยข</span></div><p style="color: #666; font-size: 12px;">1 cent</p></div><div style="text-align: center; padding: 15px; background: white; border-radius: 10px;"><h4 style="color: #333;">Nickel</h4><div style="width: 55px; height: 55px; background: #C0C0C0; border-radius: 50%; margin: 10px auto; display: flex; align-items: center; justify-content: center; border: 3px solid #808080;"><span style="color: #333; font-weight: bold;">5ยข</span></div><p style="color: #666; font-size: 12px;">5 cents</p></div><div style="text-align: center; padding: 15px; background: white; border-radius: 10px;"><h4 style="color: #333;">Dime</h4><div style="width: 45px; height: 45px; background: #C0C0C0; border-radius: 50%; margin: 10px auto; display: flex; align-items: center; justify-content: center; border: 3px solid #808080;"><span style="color: #333; font-weight: bold;">10ยข</span></div><p style="color: #666; font-size: 12px;">10 cents</p></div><div style="text-align: center; padding: 15px; background: white; border-radius: 10px;"><h4 style="color: #333;">Quarter</h4><div style="width: 60px; height: 60px; background: #C0C0C0; border-radius: 50%; margin: 10px auto; display: flex; align-items: center; justify-content: center; border: 3px solid #808080;"><span style="color: #333; font-weight: bold;">25ยข</span></div><p style="color: #666; font-size: 12px;">25 cents</p></div></div><p style="color: #333; text-align: center; margin-top: 20px; font-size: 18px;">Practice counting coins to make different amounts! ๐Ÿช™โœจ</p></div>"""
return html
# --- [The rest of your application code remains the same] ---
# Paste the boilerplate (API Key, Session State, Dialogs, Main Layout) here.
# --- API KEY & MODEL CONFIGURATION ---
load_dotenv()
api_key = None
try:
api_key = st.secrets["GOOGLE_API_KEY"]
except (KeyError, FileNotFoundError):
api_key = os.getenv("GOOGLE_API_KEY")
if api_key:
genai.configure(api_key=api_key)
model = genai.GenerativeModel(
model_name="gemini-1.5-flash",
system_instruction="""
You are "Math Jegna", an AI specializing exclusively in K-12 mathematics.
Your one and only function is to solve and explain math problems for children.
You are an AI math tutor that uses the Professor B methodology. This methodology is designed to activate children's natural learning capacities and present mathematics as a contextual, developmental story that makes sense.
IMPORTANT: When explaining mathematical concepts to young learners, mention that colorful visual aids will be provided to help illustrate the concept. Use phrases like:
- "Let's look at this in a few different ways..."
- "A fun visual will help you see how this works..."
- "Let's use an area model to understand this multiplication problem..."
- "I'll create a picture showing how we can divide these into groups..."
Always use age-appropriate language and relate math to real-world examples children understand.
You are strictly forbidden from answering any question that is not mathematical in nature. If you receive a non-mathematical question, you MUST decline with: "I can only answer math questions for students. Please ask me about numbers, shapes, counting, or other math topics!"
Keep explanations simple, encouraging, and fun for young learners.
"""
)
else:
st.error("๐Ÿšจ Google API Key not found! Please add it to your secrets or a local .env file.")
st.stop()
# --- SESSION STATE, DIALOGS, and MAIN APP LAYOUT ---
# (This entire section is identical to the previous version and is included for completeness)
if "chats" not in st.session_state:
try:
shared_chat_b64 = st.query_params.get("shared_chat")
if shared_chat_b64:
decoded_chat_json = base64.urlsafe_b64decode(shared_chat_b64).decode()
st.session_state.chats = {"Shared Chat": json.loads(decoded_chat_json)}
st.session_state.active_chat_key = "Shared Chat"
st.query_params.clear()
else: raise ValueError("No shared chat")
except (TypeError, ValueError, Exception):
saved_data_json = localS.getItem("math_mentor_chats")
if saved_data_json:
saved_data = json.loads(saved_data_json)
st.session_state.chats = saved_data.get("chats", {})
st.session_state.active_chat_key = saved_data.get("active_chat_key", "New Chat")
else:
st.session_state.chats = { "New Chat": [{"role": "assistant", "content": "Hello! I'm Math Jegna, your friendly math helper! ๐Ÿง โœจ What would you like to learn about today?"}] }
st.session_state.active_chat_key = "New Chat"
@st.dialog("Rename Chat")
def rename_chat(chat_key):
st.write(f"Enter a new name for '{chat_key}':")
new_name = st.text_input("New Name", key=f"rename_input_{chat_key}")
if st.button("Save", key=f"save_rename_{chat_key}"):
if new_name and new_name not in st.session_state.chats:
st.session_state.chats[new_name] = st.session_state.chats.pop(chat_key)
st.session_state.active_chat_key = new_name
st.rerun()
elif not new_name: st.error("Name cannot be empty.")
else: st.error("A chat with this name already exists.")
@st.dialog("Delete Chat")
def delete_chat(chat_key):
st.warning(f"Are you sure you want to delete '{chat_key}'? This cannot be undone.")
if st.button("Yes, Delete", type="primary", key=f"confirm_delete_{chat_key}"):
st.session_state.chats.pop(chat_key)
if st.session_state.active_chat_key == chat_key:
if st.session_state.chats: st.session_state.active_chat_key = next(iter(st.session_state.chats))
else:
st.session_state.chats["New Chat"] = [{"role": "assistant", "content": "Hello! Let's start a new math adventure! ๐Ÿš€"}]
st.session_state.active_chat_key = "New Chat"
st.rerun()
with st.sidebar:
st.title("๐Ÿงฎ Math Jegna")
st.write("Your K-8 AI Math Tutor")
st.divider()
for chat_key in list(st.session_state.chats.keys()):
col1, col2, col3 = st.columns([0.6, 0.2, 0.2])
with col1:
if st.button(chat_key, key=f"switch_{chat_key}", use_container_width=True, type="primary" if st.session_state.active_chat_key == chat_key else "secondary"):
st.session_state.active_chat_key = chat_key
st.rerun()
with col2:
if st.button("โœ๏ธ", key=f"rename_{chat_key}", help="Rename Chat"): rename_chat(chat_key)
with col3:
if st.button("๐Ÿ—‘๏ธ", key=f"delete_{chat_key}", help="Delete Chat"): delete_chat(chat_key)
if st.button("โž• New Chat", use_container_width=True):
new_chat_name = f"Chat {len(st.session_state.chats) + 1}"
while new_chat_name in st.session_state.chats: new_chat_name += "*"
st.session_state.chats[new_chat_name] = [{"role": "assistant", "content": "Ready for a new math problem! What's on your mind? ๐Ÿ˜ƒ"}]
st.session_state.active_chat_key = new_chat_name
st.rerun()
st.divider()
if st.button("๐Ÿ’พ Save Chats", use_container_width=True):
data_to_save = {"chats": st.session_state.chats, "active_chat_key": st.session_state.active_chat_key}
localS.setItem("math_mentor_chats", json.dumps(data_to_save))
st.toast("Chats saved to your browser!", icon="โœ…")
active_chat_history = st.session_state.chats[st.session_state.active_chat_key]
download_str = format_chat_for_download(active_chat_history)
st.download_button(label="๐Ÿ“ฅ Download Chat", data=download_str, file_name=f"{st.session_state.active_chat_key.replace(' ', '_')}_history.md", mime="text/markdown", use_container_width=True)
if st.button("๐Ÿ”— Share Chat", use_container_width=True):
chat_json = json.dumps(st.session_state.chats[st.session_state.active_chat_key])
chat_b64 = base64.urlsafe_b64encode(chat_json.encode()).decode()
share_url = f"https://huggingface.co/spaces/YOUR_SPACE_HERE?shared_chat={chat_b64}"
st.code(share_url)
st.info("Copy the URL above to share this specific chat! (Update the base URL)")
st.header(f"Chatting with Math Jegna: _{st.session_state.active_chat_key}_")
for message in st.session_state.chats[st.session_state.active_chat_key]:
with st.chat_message(message["role"]):
st.markdown(message["content"])
if "visual_html" in message and message["visual_html"]:
components.html(message["visual_html"], height=550, scrolling=True)
if prompt := st.chat_input("Ask a K-8 math question..."):
st.session_state.chats[st.session_state.active_chat_key].append({"role": "user", "content": prompt})
with st.chat_message("user"):
st.markdown(prompt)
gemini_chat_history = [{"role": convert_role_for_gemini(m["role"]), "parts": [m["content"]]} for m in st.session_state.chats[st.session_state.active_chat_key]]
with st.chat_message("assistant"):
with st.spinner("Math Jegna is thinking..."):
try:
chat_session = model.start_chat(history=gemini_chat_history)
response = chat_session.send_message(prompt, stream=True)
full_response = ""
response_container = st.empty()
for chunk in response:
full_response += chunk.text
response_container.markdown(full_response + " โ–Œ")
response_container.markdown(full_response)
visual_html_content = None
if should_generate_visual(prompt, full_response):
visual_html_content = create_visual_manipulative(prompt, full_response)
if visual_html_content:
components.html(visual_html_content, height=550, scrolling=True)
st.session_state.chats[st.session_state.active_chat_key].append({"role": "assistant", "content": full_response, "visual_html": visual_html_content})
except genai.types.generation_types.BlockedPromptException as e:
error_message = "I can only answer math questions for students. Please ask me about numbers, shapes, or other math topics!"
st.error(error_message)
st.session_state.chats[st.session_state.active_chat_key].append({"role": "assistant", "content": error_message, "visual_html": None})
except Exception as e:
st.error(f"An error occurred: {e}")