An AI-powered coding challenge platform that generates personalized learning plans and helps you improve your programming skills through daily challenges, instant feedback, and reference solutions.

1. Tell your goal — Chat with the AI coach about what you want to learn (e.g. "I want to build a car racing game in C# with Unity, 20 days and 2 hours per day").
2. Get a custom plan — The AI creates a day-by-day challenge plan tailored to your goal, timeframe, and skill level.
3. Solve & improve — Write code for each challenge, submit it, and receive an AI-generated score, feedback, and a reference solution to compare against.
4. Track progress — Monitor your completion rate, average score, streak, and score history on the progress board.

• AI-generated personalized challenge plans (powered by Google Gemini)
• Built-in code editor with syntax highlighting for Python, JavaScript, TypeScript, C#, Java, C++, Go, Rust, and more
• Instant AI code evaluation with score (0-100) and detailed feedback
• Reference solutions shown after submission
• Progress dashboard with completion tracking, score charts, and streak counter
• Progressive hint system — reveal hints one at a time when you need them
• JWT-based authentication

Frontend: React, Tailwind CSS, CodeMirror, Recharts

Backend: FastAPI, SQLAlchemy, SQLite, Google Gemini API

Auth: JWT with bcrypt password hashing

cd backend
pip install -r requirements.txt

Create a .env file in the backend directory:

SECRET_KEY=your-secret-key
GEMINI_API_KEY=your-gemini-api-key
DATABASE_URL=sqlite+aiosqlite:///./app.db
SYNC_DATABASE_URL=sqlite:///./app.db

Start the server:

uvicorn app.main:app --host 0.0.0.0 --port 8001

cd frontend
npm install
npm start

The app will be available at http://localhost:3000.

backend/
  app/
    ai/          # Gemini client, prompts, JSON parser
    routers/     # API endpoints (auth, chat, challenges, submissions, progress)
    services/    # Business logic (plan generation, code evaluation, progress)
    models/      # SQLAlchemy models
    schemas/     # Pydantic schemas
frontend/
  src/
    pages/       # HomePage, LoginPage, ChatPage, CalendarPage, ChallengePage, DashboardPage
    components/  # Reusable UI components
    hooks/       # Custom React hooks
    services/    # API client

Birmingham Hackathon 2025