Skip to content

LikhinMN/Equa-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 

Repository files navigation

Equa-AI 📐🤖

Equa-AI React Native FastAPI Gemini AI

Equa-AI is an intelligent mobile application powered by a robust backend that allows users to capture images of handwritten or printed mathematical equations and instantly receive step-by-step solutions. Utilizing Google's advanced Gemini 1.5 Flash vision model, Equa-AI accurately recognizes complex expressions and renders them beautifully in LaTeX.

✨ Features

  • 📸 Image Recognition: Seamlessly process images containing mathematical equations.
  • 🧠 AI-Powered Solving: Get accurate, step-by-step solutions powered by Google Gemini.
  • ✍️ LaTeX Rendering: Beautifully formatted mathematical output using MathJax and SVG.
  • 📱 Cross-Platform: Built with React Native and Expo for a smooth iOS and Android experience.
  • ⚡ Fast Backend: High-performance API built with FastAPI.

🛠️ Tech Stack

Frontend

  • Framework: React Native with Expo
  • Styling: NativeWind (TailwindCSS)
  • Math Rendering: react-native-mathjax-html-to-svg
  • Navigation: React Navigation

Backend

  • Framework: FastAPI (Python)
  • AI Model: Google Gemini API (gemini-1.5-flash)
  • Server: Uvicorn

🚀 Getting Started

Prerequisites

Backend Setup

  1. Navigate to the backend directory:
    cd backend
  2. Create and activate a virtual environment (optional but recommended):
    python -m venv venv
    source venv/bin/activate  # On Windows use `venv\Scripts\activate`
  3. Install dependencies:
    pip install -r requirements.txt
  4. Create a .env file in the backend directory and add your Gemini API key:
    GEMINI_API_KEY=your_google_gemini_api_key_here
  5. Start the backend server:
    python main.py
    # Or using uvicorn: uvicorn main:app --reload
    The API will be available at http://localhost:8000.

Frontend Setup

  1. Navigate to the frontend directory:
    cd equa-ai
  2. Install dependencies:
    npm install
  3. Update the API endpoint in the frontend configuration to point to your local backend (if necessary).
  4. Start the Expo development server:
    npm start
    # or
    npx expo start
  5. Scan the QR code with the Expo Go app on your phone, or run on an emulator/simulator.

📡 API Endpoints

  • GET / - Health check and status
  • POST /solve - Upload an image to get recognized math and step-by-step solutions
  • GET /health - API monitoring endpoint

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page if you want to contribute.

📝 License

This project is open-source and available under the MIT License.

About

AI-powered math solver that converts equation images into step-by-step solutions with LaTeX-rendered explanations.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors