README.md

---
title: Mathematics Question Generator
emoji: 🧮
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.29.0
app_file: app.py
pinned: false
---

# Mathematics Question Generator

This application generates customized mathematics questions on any topic you specify. Simply enter a mathematics chapter or concept you want to practice, and the AI will create questions with step-by-step solutions.

## Features

- Generate mathematics questions on any topic
- Choose the number of questions (1-10)
- Select difficulty level (elementary to advanced)
- View detailed step-by-step solutions

## How to Use

1. Enter a mathematics topic (e.g., "Linear Algebra: Eigenvalues", "Calculus: Integration")
2. Adjust the number of questions and difficulty level as needed
3. Click "Generate Questions"
4. Study the generated questions and their solutions

## Setup Requirements

This application requires a Hugging Face API token with access to the DeepSeek models. To set up your token:

1. Generate a Hugging Face API token with read access from [https://huggingface.co/settings/tokens](https://huggingface.co/settings/tokens)
2. Add this token to your Space as a secret with the key `HUGGINGFACE_TOKEN`
   - Go to your Space settings
   - Click on "Secrets"
   - Add a new secret with name `HUGGINGFACE_TOKEN` and your token as the value

## About

This application uses DeepSeek's mathematics-focused language model to generate high-quality mathematics questions tailored to your learning needs.

Created by Kamagelo Mosia