PeakPathAI 🏔️✨

PeakPathAI is an AI-powered interactive learning companion designed to enhance education through smart agents, real-time streaming, and gamified elements.

Important License Notice: This project is shared open-source for learning and inspection purposes only. You may NOT use it for commercial gain, and you may NOT distribute or host it. Please see the LICENSE file for complete details.

🚀 Features

• Advanced AI Agents: Powered by LangChain and Google Gemini to provide a personalized mentorship and learning experience.
• Microservices Architecture: A decoupled system with a robust FastAPI backend and a highly responsive Next.js frontend.
• Gamification: Includes interactive elements & designs powered by Phaser and Framer Motion to make learning fun.
• Real-time Interactions: Supports SSE (Server-Sent Events) for fluid, real-time AI responses.
• Multilingual Support: Fully internationalized (i18n) out of the box using next-intl.

🛠 Tech Stack

Frontend

• Framework: Next.js 15 (App Router, Turbopack)
• UI & Styling: React 18, Tailwind CSS, HeroUI
• Animations & Game: Framer Motion, Lottie, Phaser 4
• Localization: next-intl

Backend

• Framework: FastAPI, Uvicorn
• AI & LLM: LangChain, LangGraph, Google Gemini GenAI
• Database: SQLAlchemy, aiosqlite
• Other Tools: DuckDuckGo Search, Tavily for internet-aware agents, JWT Authentication

📦 Getting Started

Prerequisites

• Node.js (v20+)
• Python (v3.11+)

Backend Setup

1. Navigate to the backend directory:

   cd backend

2. Create a virtual environment and activate it:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Configure your .env variables (e.g., GEMINI_API_KEY).
5. Run the server:

   uvicorn app.main:app --reload

Frontend Setup

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

4. Open http://localhost:3000 with your browser to see the result.

📜 License

This project is licensed under a Custom Educational & Personal Use Only License.

• ✅ You Can: Read the code, learn from it, and run it locally for your own education.
• ❌ You Cannot: Use it commercially, make a profit from it, or distribute any part of it.

See the LICENSE file for more details.